{
  "openapi": "3.1.0",
  "info": {
    "title": "Werk API",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.getwerk.ai/api/v1"
    }
  ],
  "security": [
    {
      "key": []
    }
  ],
  "tags": [
    {
      "name": "cards",
      "x-displayName": "Cards",
      "description": "A card is one piece of work in a project: a title and description, a step, at most one holder, an optional due date, updates, photos, a list and followers."
    },
    {
      "name": "reminders",
      "x-displayName": "Reminders",
      "description": "A reminder goes off at a time for the person who set it: on a card, private until shared, or on no card in their own My Werk."
    },
    {
      "name": "projects",
      "x-displayName": "Projects",
      "description": "A project holds a team's cards and its own steps; it has one owner, admins and members."
    },
    {
      "name": "people",
      "x-displayName": "People",
      "description": "The people of a project, their roles, and the codes, links and requests that bring new people in."
    },
    {
      "name": "profile",
      "x-displayName": "Profile",
      "description": "The key's own person: their name, photo, language, time zone, settings and step templates."
    },
    {
      "name": "files",
      "x-displayName": "Files",
      "description": "The photos and documents on cards: uploading them, reading what Werk read in them, downloading and removing them."
    },
    {
      "name": "report",
      "x-displayName": "Report",
      "description": "A report sends a problem or an idea to the people who build Werk."
    }
  ],
  "paths": {
    "/project-invitation-links/resolve": {
      "post": {
        "operationId": "POST /api/v1/project-invitation-links/resolve",
        "tags": [
          "people"
        ],
        "summary": "Read an invitation link",
        "description": "What an invitation link leads to: the project's name, or why it no longer works.\n\nIt needs no key and changes nothing. A link that is unknown, expired or revoked answers its kind, not a refusal.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Content-Type"
        ],
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "pattern": "^https:\\/\\/getwerk\\.ai\\/join\\/[A-Za-z0-9_-]{43}$",
                    "description": "An invitation link, as shared."
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "url": "https://getwerk.ai/join/hs7Kq2mP9xRt4LwBvN3cJ8yZa5Qe1Ud6Gh0Fk2Ts9Xp"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the link leads to.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "valid",
                          "description": "valid when the link works, invalid when it is unknown, expired or revoked when it no longer works."
                        },
                        "projectName": {
                          "type": "string",
                          "description": "The project's name, for a valid link."
                        }
                      },
                      "required": [
                        "kind",
                        "projectName"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "invalid",
                            "expired",
                            "revoked"
                          ],
                          "description": "valid when the link works, invalid when it is unknown, expired or revoked when it no longer works."
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "kind": "valid",
                  "projectName": "Harbor Street kitchen"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/invitation-link": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/invitation-link",
        "tags": [
          "people"
        ],
        "summary": "Get the invitation link",
        "description": "The project's invitation link, one per project, valid 7 days.\n\nOpening the link sends a request to join that the owner or an admin answers; it never joins by itself.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "responses": {
          "200": {
            "description": "The link, or null when the project has none.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "link": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The link's id."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The link's version; revoking it sends it as expectedVersion."
                            },
                            "url": {
                              "type": "string",
                              "pattern": "^https:\\/\\/getwerk\\.ai\\/join\\/[A-Za-z0-9_-]{43}$",
                              "description": "The invitation link to share. Opening it sends a join request, never joins."
                            },
                            "createdAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the link was made."
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the link stops working, 7 days after it was made."
                            }
                          },
                          "required": [
                            "id",
                            "version",
                            "url",
                            "createdAt",
                            "expiresAt"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The project's invitation link, or null when it has none."
                    }
                  },
                  "required": [
                    "link"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "link": {
                    "id": "e8c2a6f0-5d9b-4e17-a3c5-8f4d6b0e2c64",
                    "version": 1,
                    "url": "https://getwerk.ai/join/hs7Kq2mP9xRt4LwBvN3cJ8yZa5Qe1Ud6Gh0Fk2Ts9Xp",
                    "createdAt": "2026-11-20T15:00:00.000Z",
                    "expiresAt": "2026-11-27T15:00:00.000Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_archived",
              "code_key_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/invitation-link",
        "tags": [
          "people"
        ],
        "summary": "Create the invitation link",
        "description": "Makes the project's invitation link, or answers the one that is still valid.\n\nThe owner and the admins who may invite make it; a new link lasts 7 days. Nobody is told.",
        "x-werk-group": "create",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d07"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The project's link.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "link": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The link's id."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The link's version; revoking it sends it as expectedVersion."
                            },
                            "url": {
                              "type": "string",
                              "pattern": "^https:\\/\\/getwerk\\.ai\\/join\\/[A-Za-z0-9_-]{43}$",
                              "description": "The invitation link to share. Opening it sends a join request, never joins."
                            },
                            "createdAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the link was made."
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the link stops working, 7 days after it was made."
                            }
                          },
                          "required": [
                            "id",
                            "version",
                            "url",
                            "createdAt",
                            "expiresAt"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The project's invitation link, or null when it has none."
                    }
                  },
                  "required": [
                    "link"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "link": {
                    "id": "e8c2a6f0-5d9b-4e17-a3c5-8f4d6b0e2c64",
                    "version": 1,
                    "url": "https://getwerk.ai/join/hs7Kq2mP9xRt4LwBvN3cJ8yZa5Qe1Ud6Gh0Fk2Ts9Xp",
                    "createdAt": "2026-11-20T15:00:00.000Z",
                    "expiresAt": "2026-11-27T15:00:00.000Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "code_key_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/invitation-link/revoke": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/invitation-link/revoke",
        "tags": [
          "people"
        ],
        "summary": "Revoke the invitation link",
        "description": "Ends the project's invitation link and makes a new one at once.\n\nThe requests to join still waiting on the old link are cancelled. The answer is the new link.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "linkId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The link's id."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The link's version as last read; when it changed since, the revoke is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "linkId",
                  "expectedVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d08",
                "linkId": "e8c2a6f0-5d9b-4e17-a3c5-8f4d6b0e2c64",
                "expectedVersion": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The new link.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "link": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The link's id."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The link's version; revoking it sends it as expectedVersion."
                            },
                            "url": {
                              "type": "string",
                              "pattern": "^https:\\/\\/getwerk\\.ai\\/join\\/[A-Za-z0-9_-]{43}$",
                              "description": "The invitation link to share. Opening it sends a join request, never joins."
                            },
                            "createdAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the link was made."
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the link stops working, 7 days after it was made."
                            }
                          },
                          "required": [
                            "id",
                            "version",
                            "url",
                            "createdAt",
                            "expiresAt"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The project's invitation link, or null when it has none."
                    }
                  },
                  "required": [
                    "link"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "link": {
                    "id": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51",
                    "version": 1,
                    "url": "https://getwerk.ai/join/Pz4nW8cQ1vYs6KjEmR2tB7xLa9Df3Hg5Nq0Uc8Vw1Ze",
                    "createdAt": "2026-11-21T14:05:00.000Z",
                    "expiresAt": "2026-11-28T14:05:00.000Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "code_key_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/project-invitation-links/request": {
      "post": {
        "operationId": "POST /api/v1/project-invitation-links/request",
        "tags": [
          "people"
        ],
        "summary": "Ask to join by link",
        "description": "Sends a request to join the project an invitation link leads to, for the owner and admins to answer.\n\nUntil it is accepted the key's person sees only the project's name. Asking again on the same link answers the request already sent; a person makes at most 10 attempts an hour.",
        "x-werk-group": "create",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "url": {
                    "type": "string",
                    "pattern": "^https:\\/\\/getwerk\\.ai\\/join\\/[A-Za-z0-9_-]{43}$",
                    "description": "The invitation link, as shared."
                  }
                },
                "required": [
                  "clientRequestId",
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d09",
                "url": "https://getwerk.ai/join/hs7Kq2mP9xRt4LwBvN3cJ8yZa5Qe1Ud6Gh0Fk2Ts9Xp"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request to join, or why none was sent.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "request": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The join request's id."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The request's version; an answer to it sends it as expectedVersion."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "pending",
                                "approved",
                                "rejected",
                                "cancelled",
                                "expired"
                              ],
                              "description": "pending while it waits for an answer, approved or rejected once answered, cancelled when the link it came from was revoked, expired when nobody answered in time."
                            },
                            "createdAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the request was sent."
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the request lapses if nobody answers it."
                            },
                            "resolvedAt": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "date-time",
                                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "When it was answered, cancelled or lapsed, or null while pending."
                            },
                            "projectName": {
                              "type": "string",
                              "description": "The name of the project the request is for."
                            }
                          },
                          "required": [
                            "id",
                            "version",
                            "state",
                            "createdAt",
                            "expiresAt",
                            "resolvedAt",
                            "projectName"
                          ],
                          "additionalProperties": false,
                          "description": "The request to join."
                        }
                      },
                      "required": [
                        "request"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "invalid",
                            "expired",
                            "revoked",
                            "already_member"
                          ],
                          "description": "invalid, expired or revoked when the link does not work; already_member when the key's person is in the project."
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "request": {
                    "id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
                    "version": 1,
                    "state": "pending",
                    "createdAt": "2026-11-20T18:10:00.000Z",
                    "expiresAt": "2026-12-20T18:10:00.000Z",
                    "resolvedAt": null,
                    "projectName": "Harbor Street kitchen"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/join-requests": {
      "get": {
        "operationId": "GET /api/v1/account/join-requests",
        "tags": [
          "people"
        ],
        "summary": "List my join requests",
        "description": "The key's person's own requests to join projects, newest first, in every state.\n\nA request that waited past its time reads expired.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many requests a page holds.",
            "schema": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,2}$"
            },
            "example": "20"
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requests.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "requests": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The join request's id."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The request's version; an answer to it sends it as expectedVersion."
                          },
                          "state": {
                            "type": "string",
                            "enum": [
                              "pending",
                              "approved",
                              "rejected",
                              "cancelled",
                              "expired"
                            ],
                            "description": "pending while it waits for an answer, approved or rejected once answered, cancelled when the link it came from was revoked, expired when nobody answered in time."
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the request was sent."
                          },
                          "expiresAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the request lapses if nobody answers it."
                          },
                          "resolvedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When it was answered, cancelled or lapsed, or null while pending."
                          },
                          "projectName": {
                            "type": "string",
                            "description": "The name of the project the request is for."
                          }
                        },
                        "required": [
                          "id",
                          "version",
                          "state",
                          "createdAt",
                          "expiresAt",
                          "resolvedAt",
                          "projectName"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The key's person's own requests to join projects."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "requests",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "requests": [
                    {
                      "id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
                      "version": 1,
                      "state": "pending",
                      "createdAt": "2026-11-20T18:10:00.000Z",
                      "expiresAt": "2026-12-20T18:10:00.000Z",
                      "resolvedAt": null,
                      "projectName": "Harbor Street kitchen"
                    }
                  ],
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/join-requests/{requestId}": {
      "get": {
        "operationId": "GET /api/v1/account/join-requests/:requestId",
        "tags": [
          "people"
        ],
        "summary": "Get a join request",
        "description": "One of the key's person's own requests to join a project.\n\nOnly the key's person's own requests are found.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "requestId",
            "in": "path",
            "required": true,
            "description": "The request's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75"
          }
        ],
        "responses": {
          "200": {
            "description": "The request.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "request": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The join request's id."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The request's version; an answer to it sends it as expectedVersion."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "approved",
                            "rejected",
                            "cancelled",
                            "expired"
                          ],
                          "description": "pending while it waits for an answer, approved or rejected once answered, cancelled when the link it came from was revoked, expired when nobody answered in time."
                        },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the request was sent."
                        },
                        "expiresAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the request lapses if nobody answers it."
                        },
                        "resolvedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When it was answered, cancelled or lapsed, or null while pending."
                        },
                        "projectName": {
                          "type": "string",
                          "description": "The name of the project the request is for."
                        }
                      },
                      "required": [
                        "id",
                        "version",
                        "state",
                        "createdAt",
                        "expiresAt",
                        "resolvedAt",
                        "projectName"
                      ],
                      "additionalProperties": false,
                      "description": "The request to join."
                    }
                  },
                  "required": [
                    "request"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "request": {
                    "id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
                    "version": 1,
                    "state": "pending",
                    "createdAt": "2026-11-20T18:10:00.000Z",
                    "expiresAt": "2026-12-20T18:10:00.000Z",
                    "resolvedAt": null,
                    "projectName": "Harbor Street kitchen"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/join-requests": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/join-requests",
        "tags": [
          "people"
        ],
        "summary": "List a project's join requests",
        "description": "The requests to join the project still waiting for an answer, newest first.\n\nThe owner and the admins who may invite read them.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many requests a page holds.",
            "schema": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,2}$"
            },
            "example": "20"
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requests.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "requests": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The join request's id."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The request's version; an answer to it sends it as expectedVersion."
                          },
                          "state": {
                            "type": "string",
                            "enum": [
                              "pending",
                              "approved",
                              "rejected",
                              "cancelled",
                              "expired"
                            ],
                            "description": "pending while it waits for an answer, approved or rejected once answered, cancelled when the link it came from was revoked, expired when nobody answered in time."
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the request was sent."
                          },
                          "expiresAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the request lapses if nobody answers it."
                          },
                          "resolvedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When it was answered, cancelled or lapsed, or null while pending."
                          },
                          "requester": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "displayName": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128,
                                "description": "The person's name."
                              }
                            },
                            "required": [
                              "id",
                              "displayName"
                            ],
                            "additionalProperties": false,
                            "description": "The person asking to join."
                          }
                        },
                        "required": [
                          "id",
                          "version",
                          "state",
                          "createdAt",
                          "expiresAt",
                          "resolvedAt",
                          "requester"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The requests to join the project."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "requests",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "requests": [
                    {
                      "id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
                      "version": 1,
                      "state": "pending",
                      "createdAt": "2026-11-20T18:10:00.000Z",
                      "expiresAt": "2026-12-20T18:10:00.000Z",
                      "resolvedAt": null,
                      "requester": {
                        "id": "1b2c3d4e-5f60-4718-9a2b-3c4d5e6f7a81",
                        "displayName": "Sam Rivera"
                      }
                    }
                  ],
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/join-requests/{requestId}/respond": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/join-requests/:requestId/respond",
        "tags": [
          "people"
        ],
        "summary": "Answer a join request",
        "description": "Accepts a request to join the project, which adds its person, or rejects it.\n\nThe owner and the admins who may invite answer it; anyone else reads it as not found. The person who asked is told; a request already answered answers its state unchanged.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "requestId",
            "in": "path",
            "required": true,
            "description": "The request's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The request's version as last read; when it changed since, the answer is refused."
                  },
                  "decision": {
                    "type": "string",
                    "enum": [
                      "accept",
                      "reject"
                    ],
                    "description": "accept adds the person to the project, reject turns the request down."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "decision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d10",
                "expectedVersion": 1,
                "decision": "accept"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The request after the answer.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "request": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The join request's id."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The request's version; an answer to it sends it as expectedVersion."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "approved",
                            "rejected",
                            "cancelled",
                            "expired"
                          ],
                          "description": "pending while it waits for an answer, approved or rejected once answered, cancelled when the link it came from was revoked, expired when nobody answered in time."
                        },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the request was sent."
                        },
                        "expiresAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the request lapses if nobody answers it."
                        },
                        "resolvedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When it was answered, cancelled or lapsed, or null while pending."
                        }
                      },
                      "required": [
                        "id",
                        "version",
                        "state",
                        "createdAt",
                        "expiresAt",
                        "resolvedAt"
                      ],
                      "additionalProperties": false,
                      "description": "The request to join."
                    }
                  },
                  "required": [
                    "request"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "request": {
                    "id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
                    "version": 2,
                    "state": "approved",
                    "createdAt": "2026-11-20T18:10:00.000Z",
                    "expiresAt": "2026-12-20T18:10:00.000Z",
                    "resolvedAt": "2026-11-21T14:05:00.000Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/profile": {
      "get": {
        "operationId": "GET /api/v1/account/profile",
        "tags": [
          "profile"
        ],
        "summary": "Get the profile",
        "description": "The key's person: their name, photo, email, language, time zone, daily brief and mail choices.\n\nWhat a key reaches is this person's: every route acts as them.",
        "x-werk-group": "read",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The profile.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "personId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The key's person's id."
                    },
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "Their name, as they set it."
                    },
                    "photo": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "personId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person whose photo it is."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                            }
                          },
                          "required": [
                            "personId",
                            "version"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Their photo, or null."
                    },
                    "email": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "email",
                          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Their verified email, or null."
                    },
                    "briefTime": {
                      "type": "string",
                      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                      "description": "The time of day their daily brief comes, as HH:MM in their time zone."
                    },
                    "briefOn": {
                      "type": "boolean",
                      "description": "True when they get the daily brief."
                    },
                    "pauseResumeDate": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The day a paused brief starts again, or null."
                    },
                    "timeZone": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Their time zone, or null when not known."
                    },
                    "deviceLocale": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The language of the device they last used, or null."
                    },
                    "locale": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The language they chose for Werk, or null to follow their device."
                    },
                    "emailDueNotices": {
                      "type": "boolean",
                      "description": "True when due notices also come by email."
                    },
                    "emailOwnReminders": {
                      "type": "boolean",
                      "description": "True when their reminders, shared ones included, also come by email."
                    },
                    "emailInvitations": {
                      "type": "boolean",
                      "description": "True when invitations also come by email."
                    },
                    "translateCards": {
                      "type": "boolean",
                      "description": "True when Werk translates cards written in other languages into theirs."
                    },
                    "translateOffer": {
                      "type": "string",
                      "enum": [
                        "open",
                        "never"
                      ],
                      "description": "open while Werk may offer to translate, never once they declined for good."
                    },
                    "googleCalendar": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_connected",
                                "connecting",
                                "connected",
                                "no_access",
                                "disconnected"
                              ],
                              "description": "not_connected, connecting while it is being set up, connected, no_access once Werk lost access, or disconnected."
                            },
                            "account": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "email",
                                  "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The Google account connected, or null."
                            },
                            "matchedAt": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "date-time",
                                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "When the Werk calendar last held the whole agenda, or null."
                            },
                            "reason": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "access_withdrawn",
                                    "calendar_removed",
                                    "werk_error"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why the connection stopped: access withdrawn, the calendar removed, or an error of Werk's; null otherwise."
                            }
                          },
                          "required": [
                            "state",
                            "account",
                            "matchedAt",
                            "reason"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Their Google Calendar connection, or null when Werk offers no Google Calendar connection."
                    }
                  },
                  "required": [
                    "personId",
                    "name",
                    "photo",
                    "email",
                    "briefTime",
                    "briefOn",
                    "pauseResumeDate",
                    "timeZone",
                    "deviceLocale",
                    "locale",
                    "emailDueNotices",
                    "emailOwnReminders",
                    "emailInvitations",
                    "translateCards",
                    "translateOffer",
                    "googleCalendar"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                  "name": "Maya Chen",
                  "photo": {
                    "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                    "version": 1
                  },
                  "email": "maya@harborstreet.example",
                  "briefTime": "07:30",
                  "briefOn": true,
                  "pauseResumeDate": null,
                  "timeZone": "America/New_York",
                  "deviceLocale": "en-US",
                  "locale": null,
                  "emailDueNotices": true,
                  "emailOwnReminders": false,
                  "emailInvitations": true,
                  "translateCards": true,
                  "translateOffer": "open",
                  "googleCalendar": {
                    "state": "not_connected",
                    "account": null,
                    "matchedAt": null,
                    "reason": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/language": {
      "put": {
        "operationId": "PUT /api/v1/account/language",
        "tags": [
          "profile"
        ],
        "summary": "Change the language",
        "description": "Sets the language Werk uses with the key's person, or makes it follow their device again.\n\nThe tag is matched to a language Werk serves; one it serves none of is refused.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "locale": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 64
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The language for Werk, as a BCP 47 language tag; null follows the device again."
                  }
                },
                "required": [
                  "clientRequestId",
                  "locale"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c02",
                "locale": "en-US"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The language after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "locale": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The language Werk uses with the key's person now, or null to follow their device."
                    }
                  },
                  "required": [
                    "locale"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "locale": "en-US"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_account_request",
              "locale_unserved"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/google-calendar/disconnect": {
      "post": {
        "operationId": "POST /api/v1/account/google-calendar/disconnect",
        "tags": [
          "profile"
        ],
        "summary": "Disconnect Google Calendar",
        "description": "Ends the key's person's Google Calendar connection.\n\nWerk lets go of its access; the Werk calendar and its events stay in their Google account.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c09"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The connection after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "not_connected",
                        "connecting",
                        "connected",
                        "no_access",
                        "disconnected"
                      ],
                      "description": "not_connected, connecting while it is being set up, connected, no_access once Werk lost access, or disconnected."
                    },
                    "account": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "email",
                          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The Google account connected, or null."
                    },
                    "matchedAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When the Werk calendar last held the whole agenda, or null."
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "type": "string",
                          "enum": [
                            "access_withdrawn",
                            "calendar_removed",
                            "werk_error"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Why the connection stopped: access withdrawn, the calendar removed, or an error of Werk's; null otherwise."
                    }
                  },
                  "required": [
                    "state",
                    "account",
                    "matchedAt",
                    "reason"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "state": "disconnected",
                  "account": null,
                  "matchedAt": null,
                  "reason": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_account_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects": {
      "post": {
        "operationId": "POST /api/v1/projects",
        "tags": [
          "projects"
        ],
        "summary": "Create a project",
        "description": "Creates a project owned by the key's person.\n\nIts steps come from a template, Werk's Simple one when none is named, or are given whole. A photo uploaded first can be made its photo.",
        "x-werk-group": "create",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "photoAssetId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "A photo uploaded first with POST /assets, made the project's photo."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "description": "The project's name."
                  },
                  "templateId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "simple",
                          "technicians",
                          "software",
                          "home"
                        ]
                      },
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      }
                    ],
                    "description": "The step template the project's steps come from; left out, Werk's own Simple template."
                  },
                  "steps": {
                    "minItems": 2,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "maxLength": 64,
                          "pattern": "^[a-z][a-z0-9_]*$",
                          "description": "The step's id: an existing step's id keeps that step and its cards, a new id adds a step."
                        },
                        "label": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "locale_key",
                                  "description": "locale_key for one of Werk's own words, written in each reader's language; text for a name as written."
                                },
                                "key": {
                                  "type": "string",
                                  "enum": [
                                    "project_steps.steps.open",
                                    "project_steps.steps.in_progress",
                                    "project_steps.steps.waiting_parts",
                                    "project_steps.steps.done",
                                    "project_steps.steps.paid",
                                    "project_steps.steps.in_review"
                                  ],
                                  "description": "Which of Werk's own words names the step."
                                }
                              },
                              "required": [
                                "kind",
                                "key"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "text",
                                  "description": "locale_key for one of Werk's own words, written in each reader's language; text for a name as written."
                                },
                                "text": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 60,
                                  "description": "The step's name, as written."
                                }
                              },
                              "required": [
                                "kind",
                                "text"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "The step's name: one of Werk's own words, or a name as written."
                        },
                        "bucket": {
                          "type": "string",
                          "enum": [
                            "new",
                            "in_progress",
                            "waiting",
                            "resolved",
                            "closed"
                          ],
                          "description": "The kind of step: the first step must be new, in_progress or waiting, and the last resolved or closed."
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "bucket"
                      ],
                      "additionalProperties": false
                    },
                    "description": "The project's steps, in order; given, they are taken instead of the template's."
                  }
                },
                "required": [
                  "clientRequestId",
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b01",
                "name": "Harbor Street kitchen",
                "templateId": "technicians"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The new project and its steps.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversation": {
                      "type": "object",
                      "properties": {
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id."
                        },
                        "color": {
                          "type": "string",
                          "enum": [
                            "pink",
                            "tangerine",
                            "yellow",
                            "green",
                            "turquoise",
                            "sky",
                            "blue",
                            "violet"
                          ],
                          "description": "The color the key's person sees the project in."
                        },
                        "highlighted": {
                          "type": "boolean",
                          "description": "True when the key's person marked the project to stand out in their list."
                        },
                        "appearanceRevision": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "Grows with each change to the key's person's color or mark for the project."
                        },
                        "id": {
                          "type": "string",
                          "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                        },
                        "listPosition": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The key's person's own place for the project in their list, or null while they never ordered it."
                        },
                        "peopleVersion": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's people, which changes whenever its people do."
                        },
                        "statusLine": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "One line Werk writes from the project's cards on how the project is going, or null before there is one."
                        },
                        "statusLineAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When that line was written."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the project is archived."
                        },
                        "personal": {
                          "default": false,
                          "type": "boolean",
                          "description": "True for the key's person's own project, My Werk, which nobody else joins."
                        },
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "invite": {
                              "type": "boolean",
                              "description": "True when the key's person may invite people to the project."
                            },
                            "managePeople": {
                              "type": "boolean",
                              "description": "True when they may manage the project's people."
                            },
                            "changeRoles": {
                              "type": "boolean",
                              "description": "True when they may make a person an admin or a member."
                            },
                            "removePeople": {
                              "type": "boolean",
                              "description": "True when they may remove people from the project."
                            },
                            "editLists": {
                              "type": "boolean",
                              "description": "True when they may change the project's steps."
                            },
                            "archive": {
                              "type": "boolean",
                              "description": "True when they may archive the project."
                            },
                            "restore": {
                              "type": "boolean",
                              "description": "True when they may bring the project back from the archive."
                            },
                            "delete": {
                              "type": "boolean",
                              "description": "True when they may delete the project."
                            },
                            "transferOwnership": {
                              "type": "boolean",
                              "description": "True when they may hand the project to another person and leave it."
                            },
                            "rename": {
                              "type": "boolean",
                              "description": "True when they may rename the project."
                            },
                            "changePhoto": {
                              "type": "boolean",
                              "description": "True when they may change the project's photo."
                            },
                            "leave": {
                              "type": "boolean",
                              "description": "True when they may leave the project."
                            }
                          },
                          "required": [
                            "invite",
                            "managePeople",
                            "changeRoles",
                            "removePeople",
                            "editLists",
                            "archive",
                            "restore",
                            "delete",
                            "transferOwnership",
                            "rename",
                            "changePhoto",
                            "leave"
                          ],
                          "additionalProperties": false,
                          "description": "What the key's person may do with the project now."
                        },
                        "title": {
                          "type": "string",
                          "description": "The project's name."
                        },
                        "lastActivityAt": {
                          "type": "string",
                          "description": "When something last happened in the project that the key's person sees: a chat message or a card change."
                        },
                        "isOwner": {
                          "type": "boolean",
                          "description": "True when the key's person owns the project."
                        },
                        "ownerName": {
                          "type": "string",
                          "description": "The owner's name."
                        },
                        "memberCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many people the project has."
                        },
                        "members": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "firstName": {
                                "type": "string",
                                "description": "The person's first name."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "id",
                              "initials"
                            ],
                            "additionalProperties": false
                          },
                          "description": "A few of the project's people, for its avatars."
                        },
                        "viewerRole": {
                          "type": "string",
                          "enum": [
                            "owner",
                            "admin",
                            "member",
                            "collaborator"
                          ],
                          "description": "The key's person's role in the project."
                        },
                        "photo": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "version"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The project's photo, or null when it has none."
                        },
                        "dueTodayCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Open cards due today."
                        },
                        "closedCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards on the project's last step, archived ones included."
                        },
                        "openCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards neither archived nor on the project's last step."
                        },
                        "offerTranslation": {
                          "type": "object",
                          "properties": {
                            "languages": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64
                              },
                              "description": "The languages those cards are written in."
                            },
                            "target": {
                              "type": "string",
                              "description": "The key's person's language, which they would be translated into."
                            }
                          },
                          "required": [
                            "languages",
                            "target"
                          ],
                          "additionalProperties": false,
                          "description": "Present while Werk offers the key's person to translate the project's cards that others wrote in other languages."
                        },
                        "currentOpenCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The project's open cards, as its card list counts them."
                        },
                        "projectConfigVersion": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                        }
                      },
                      "required": [
                        "color",
                        "highlighted",
                        "appearanceRevision",
                        "id",
                        "archived",
                        "personal",
                        "title",
                        "lastActivityAt",
                        "isOwner",
                        "ownerName",
                        "viewerRole",
                        "photo",
                        "dueTodayCount",
                        "closedCardCount",
                        "openCardCount"
                      ],
                      "additionalProperties": false,
                      "description": "The new project, as the key's person sees it in their list."
                    },
                    "steps": {
                      "type": "object",
                      "properties": {
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "invite": {
                              "type": "boolean",
                              "description": "True when the key's person may invite people to the project."
                            },
                            "managePeople": {
                              "type": "boolean",
                              "description": "True when they may manage the project's people."
                            },
                            "changeRoles": {
                              "type": "boolean",
                              "description": "True when they may make a person an admin or a member."
                            },
                            "removePeople": {
                              "type": "boolean",
                              "description": "True when they may remove people from the project."
                            },
                            "editLists": {
                              "type": "boolean",
                              "description": "True when they may change the project's steps."
                            },
                            "archive": {
                              "type": "boolean",
                              "description": "True when they may archive the project."
                            },
                            "restore": {
                              "type": "boolean",
                              "description": "True when they may bring the project back from the archive."
                            },
                            "delete": {
                              "type": "boolean",
                              "description": "True when they may delete the project."
                            },
                            "transferOwnership": {
                              "type": "boolean",
                              "description": "True when they may hand the project to another person and leave it."
                            },
                            "rename": {
                              "type": "boolean",
                              "description": "True when they may rename the project."
                            },
                            "changePhoto": {
                              "type": "boolean",
                              "description": "True when they may change the project's photo."
                            },
                            "leave": {
                              "type": "boolean",
                              "description": "True when they may leave the project."
                            }
                          },
                          "required": [
                            "invite",
                            "managePeople",
                            "changeRoles",
                            "removePeople",
                            "editLists",
                            "archive",
                            "restore",
                            "delete",
                            "transferOwnership",
                            "rename",
                            "changePhoto",
                            "leave"
                          ],
                          "additionalProperties": false,
                          "description": "What the key's person may do with the project now."
                        },
                        "configVersion": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                        },
                        "steps": {
                          "minItems": 2,
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "maxLength": 64,
                                "pattern": "^[a-z][a-z0-9_]*$",
                                "description": "The step's id; a card's step names it as stepId."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 60,
                                "description": "The step's name, in the reader's language when it is one of Werk's own words."
                              },
                              "labelLanguage": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The language a name the project wrote is written in; absent for one of Werk's own words."
                              },
                              "labelTranslation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "A name the project wrote, in the reader's language, when it is written in another."
                              },
                              "labelSource": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "locale_key",
                                        "description": "locale_key for one of Werk's own words, text for a name as written."
                                      },
                                      "key": {
                                        "type": "string",
                                        "enum": [
                                          "project_steps.steps.open",
                                          "project_steps.steps.in_progress",
                                          "project_steps.steps.waiting_parts",
                                          "project_steps.steps.done",
                                          "project_steps.steps.paid",
                                          "project_steps.steps.in_review"
                                        ],
                                        "description": "Which of Werk's own words names the step."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "key"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "text",
                                        "description": "locale_key for one of Werk's own words, text for a name as written."
                                      },
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 60,
                                        "description": "The name, as written."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "text"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "description": "The name as stored: one of Werk's own words, or a name as written. A change of steps sends it back as label."
                              },
                              "bucket": {
                                "type": "string",
                                "enum": [
                                  "new",
                                  "in_progress",
                                  "waiting",
                                  "resolved",
                                  "closed"
                                ],
                                "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 99,
                                "description": "The step's place among the project's steps, from 0."
                              },
                              "cardCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "How many cards are on the step."
                              }
                            },
                            "required": [
                              "id",
                              "label",
                              "labelSource",
                              "bucket",
                              "position",
                              "cardCount"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The project's steps, in order."
                        }
                      },
                      "required": [
                        "configVersion",
                        "steps"
                      ],
                      "additionalProperties": false,
                      "description": "The new project's steps."
                    }
                  },
                  "required": [
                    "conversation",
                    "steps"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversation": {
                    "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                    "color": "turquoise",
                    "highlighted": false,
                    "appearanceRevision": 1,
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "listPosition": 0,
                    "peopleVersion": 1,
                    "statusLine": null,
                    "statusLineAt": null,
                    "archived": false,
                    "personal": false,
                    "capabilities": {
                      "invite": true,
                      "managePeople": true,
                      "changeRoles": true,
                      "removePeople": true,
                      "editLists": true,
                      "archive": true,
                      "restore": false,
                      "delete": true,
                      "transferOwnership": true,
                      "rename": true,
                      "changePhoto": true,
                      "leave": true
                    },
                    "title": "Harbor Street kitchen",
                    "lastActivityAt": "2026-11-21T13:35:00.000Z",
                    "isOwner": true,
                    "ownerName": "Maya Chen",
                    "memberCount": 1,
                    "members": [
                      {
                        "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "firstName": "Maya",
                        "initials": "MC"
                      }
                    ],
                    "viewerRole": "owner",
                    "photo": null,
                    "dueTodayCount": 0,
                    "closedCardCount": 0,
                    "openCardCount": 0,
                    "currentOpenCardCount": 0,
                    "projectConfigVersion": 1
                  },
                  "steps": {
                    "capabilities": {
                      "invite": true,
                      "managePeople": true,
                      "changeRoles": true,
                      "removePeople": true,
                      "editLists": true,
                      "archive": true,
                      "restore": false,
                      "delete": true,
                      "transferOwnership": true,
                      "rename": true,
                      "changePhoto": true,
                      "leave": true
                    },
                    "configVersion": 1,
                    "steps": [
                      {
                        "id": "open",
                        "label": "Pending",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.open"
                        },
                        "bucket": "new",
                        "position": 0,
                        "cardCount": 0
                      },
                      {
                        "id": "in_progress",
                        "label": "In progress",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.in_progress"
                        },
                        "bucket": "in_progress",
                        "position": 1,
                        "cardCount": 0
                      },
                      {
                        "id": "waiting_parts",
                        "label": "Waiting for parts",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.waiting_parts"
                        },
                        "bucket": "waiting",
                        "position": 2,
                        "cardCount": 0
                      },
                      {
                        "id": "done",
                        "label": "Done",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.done"
                        },
                        "bucket": "resolved",
                        "position": 3,
                        "cardCount": 0
                      },
                      {
                        "id": "paid",
                        "label": "Paid",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.paid"
                        },
                        "bucket": "closed",
                        "position": 4,
                        "cardCount": 0
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_name",
              "too_few_project_steps",
              "too_many_project_steps",
              "duplicate_project_step",
              "project_first_step_not_open",
              "project_last_step_not_finished",
              "invalid_project_step_label",
              "invalid_project_request",
              "photo_side_too_large",
              "unsupported_media_type",
              "invalid_media"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_for_client"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "asset_not_found",
              "template_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "reserved_project_name",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects",
        "tags": [
          "projects"
        ],
        "summary": "List projects",
        "description": "The projects the key's person is in, as their project list shows them.\n\nActive projects by default, or the archived ones. A project waiting to be deleted is left out.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "active for projects in use, archived for archived ones.",
            "schema": {
              "default": "active",
              "type": "string",
              "enum": [
                "active",
                "archived"
              ]
            },
            "example": "active"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The projects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "projectId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The project's id."
                          },
                          "color": {
                            "type": "string",
                            "enum": [
                              "pink",
                              "tangerine",
                              "yellow",
                              "green",
                              "turquoise",
                              "sky",
                              "blue",
                              "violet"
                            ],
                            "description": "The color the key's person sees the project in."
                          },
                          "highlighted": {
                            "type": "boolean",
                            "description": "True when the key's person marked the project to stand out in their list."
                          },
                          "appearanceRevision": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 9007199254740991,
                            "description": "Grows with each change to the key's person's color or mark for the project."
                          },
                          "id": {
                            "type": "string",
                            "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                          },
                          "listPosition": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The key's person's own place for the project in their list, or null while they never ordered it."
                          },
                          "peopleVersion": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The version of the project's people, which changes whenever its people do."
                          },
                          "statusLine": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "One line Werk writes from the project's cards on how the project is going, or null before there is one."
                          },
                          "statusLineAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When that line was written."
                          },
                          "archived": {
                            "type": "boolean",
                            "description": "True when the project is archived."
                          },
                          "personal": {
                            "default": false,
                            "type": "boolean",
                            "description": "True for the key's person's own project, My Werk, which nobody else joins."
                          },
                          "capabilities": {
                            "type": "object",
                            "properties": {
                              "invite": {
                                "type": "boolean",
                                "description": "True when the key's person may invite people to the project."
                              },
                              "managePeople": {
                                "type": "boolean",
                                "description": "True when they may manage the project's people."
                              },
                              "changeRoles": {
                                "type": "boolean",
                                "description": "True when they may make a person an admin or a member."
                              },
                              "removePeople": {
                                "type": "boolean",
                                "description": "True when they may remove people from the project."
                              },
                              "editLists": {
                                "type": "boolean",
                                "description": "True when they may change the project's steps."
                              },
                              "archive": {
                                "type": "boolean",
                                "description": "True when they may archive the project."
                              },
                              "restore": {
                                "type": "boolean",
                                "description": "True when they may bring the project back from the archive."
                              },
                              "delete": {
                                "type": "boolean",
                                "description": "True when they may delete the project."
                              },
                              "transferOwnership": {
                                "type": "boolean",
                                "description": "True when they may hand the project to another person and leave it."
                              },
                              "rename": {
                                "type": "boolean",
                                "description": "True when they may rename the project."
                              },
                              "changePhoto": {
                                "type": "boolean",
                                "description": "True when they may change the project's photo."
                              },
                              "leave": {
                                "type": "boolean",
                                "description": "True when they may leave the project."
                              }
                            },
                            "required": [
                              "invite",
                              "managePeople",
                              "changeRoles",
                              "removePeople",
                              "editLists",
                              "archive",
                              "restore",
                              "delete",
                              "transferOwnership",
                              "rename",
                              "changePhoto",
                              "leave"
                            ],
                            "additionalProperties": false,
                            "description": "What the key's person may do with the project now."
                          },
                          "title": {
                            "type": "string",
                            "description": "The project's name."
                          },
                          "lastActivityAt": {
                            "type": "string",
                            "description": "When something last happened in the project that the key's person sees: a chat message or a card change."
                          },
                          "isOwner": {
                            "type": "boolean",
                            "description": "True when the key's person owns the project."
                          },
                          "ownerName": {
                            "type": "string",
                            "description": "The owner's name."
                          },
                          "memberCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many people the project has."
                          },
                          "members": {
                            "maxItems": 3,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person's id."
                                },
                                "firstName": {
                                  "type": "string",
                                  "description": "The person's first name."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The person's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The person's photo, when they have one."
                                }
                              },
                              "required": [
                                "id",
                                "initials"
                              ],
                              "additionalProperties": false
                            },
                            "description": "A few of the project's people, for its avatars."
                          },
                          "viewerRole": {
                            "type": "string",
                            "enum": [
                              "owner",
                              "admin",
                              "member",
                              "collaborator"
                            ],
                            "description": "The key's person's role in the project."
                          },
                          "photo": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "version": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "version"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The project's photo, or null when it has none."
                          },
                          "dueTodayCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Open cards due today."
                          },
                          "closedCardCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cards on the project's last step, archived ones included."
                          },
                          "openCardCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cards neither archived nor on the project's last step."
                          },
                          "offerTranslation": {
                            "type": "object",
                            "properties": {
                              "languages": {
                                "minItems": 1,
                                "maxItems": 20,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64
                                },
                                "description": "The languages those cards are written in."
                              },
                              "target": {
                                "type": "string",
                                "description": "The key's person's language, which they would be translated into."
                              }
                            },
                            "required": [
                              "languages",
                              "target"
                            ],
                            "additionalProperties": false,
                            "description": "Present while Werk offers the key's person to translate the project's cards that others wrote in other languages."
                          },
                          "currentOpenCardCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The project's open cards, as its card list counts them."
                          },
                          "projectConfigVersion": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 9007199254740991,
                            "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                          }
                        },
                        "required": [
                          "color",
                          "highlighted",
                          "appearanceRevision",
                          "id",
                          "archived",
                          "personal",
                          "title",
                          "lastActivityAt",
                          "isOwner",
                          "ownerName",
                          "viewerRole",
                          "photo",
                          "dueTodayCount",
                          "closedCardCount",
                          "openCardCount"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The projects, in the key's person's list order."
                    }
                  },
                  "required": [
                    "conversations"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversations": [
                    {
                      "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                      "color": "turquoise",
                      "highlighted": false,
                      "appearanceRevision": 1,
                      "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                      "listPosition": 0,
                      "peopleVersion": 3,
                      "statusLine": "#12 Replace the leaking sink faucet is waiting for parts; two more cards are in progress.",
                      "statusLineAt": "2026-11-21T13:40:00.000Z",
                      "archived": false,
                      "personal": false,
                      "capabilities": {
                        "invite": true,
                        "managePeople": true,
                        "changeRoles": true,
                        "removePeople": true,
                        "editLists": true,
                        "archive": true,
                        "restore": false,
                        "delete": true,
                        "transferOwnership": true,
                        "rename": true,
                        "changePhoto": true,
                        "leave": true
                      },
                      "title": "Harbor Street kitchen",
                      "lastActivityAt": "2026-11-21T13:35:00.000Z",
                      "isOwner": true,
                      "ownerName": "Maya Chen",
                      "memberCount": 3,
                      "members": [
                        {
                          "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                          "firstName": "Maya",
                          "initials": "MC"
                        },
                        {
                          "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                          "firstName": "Tom",
                          "initials": "TO"
                        },
                        {
                          "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                          "firstName": "Lucia",
                          "initials": "LF"
                        }
                      ],
                      "viewerRole": "owner",
                      "photo": {
                        "version": 2
                      },
                      "dueTodayCount": 0,
                      "closedCardCount": 4,
                      "openCardCount": 3,
                      "currentOpenCardCount": 3,
                      "projectConfigVersion": 6
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}": {
      "patch": {
        "operationId": "PATCH /api/v1/projects/:projectId",
        "tags": [
          "projects"
        ],
        "summary": "Rename a project",
        "description": "Renames the project.\n\nThe project's owner and admins may rename it; My Werk keeps its name. The rename is refused when the project's settings changed since they were read.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "description": "The project's new name."
                  },
                  "expectedConfigVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The project's projectConfigVersion as last read; when its settings changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "name",
                  "expectedConfigVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b02",
                "name": "Harbor Street kitchen and bath",
                "expectedConfigVersion": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversation": {
                      "type": "object",
                      "properties": {
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id."
                        },
                        "color": {
                          "type": "string",
                          "enum": [
                            "pink",
                            "tangerine",
                            "yellow",
                            "green",
                            "turquoise",
                            "sky",
                            "blue",
                            "violet"
                          ],
                          "description": "The color the key's person sees the project in."
                        },
                        "highlighted": {
                          "type": "boolean",
                          "description": "True when the key's person marked the project to stand out in their list."
                        },
                        "appearanceRevision": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "Grows with each change to the key's person's color or mark for the project."
                        },
                        "id": {
                          "type": "string",
                          "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                        },
                        "listPosition": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The key's person's own place for the project in their list, or null while they never ordered it."
                        },
                        "peopleVersion": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's people, which changes whenever its people do."
                        },
                        "statusLine": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "One line Werk writes from the project's cards on how the project is going, or null before there is one."
                        },
                        "statusLineAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When that line was written."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the project is archived."
                        },
                        "personal": {
                          "default": false,
                          "type": "boolean",
                          "description": "True for the key's person's own project, My Werk, which nobody else joins."
                        },
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "invite": {
                              "type": "boolean",
                              "description": "True when the key's person may invite people to the project."
                            },
                            "managePeople": {
                              "type": "boolean",
                              "description": "True when they may manage the project's people."
                            },
                            "changeRoles": {
                              "type": "boolean",
                              "description": "True when they may make a person an admin or a member."
                            },
                            "removePeople": {
                              "type": "boolean",
                              "description": "True when they may remove people from the project."
                            },
                            "editLists": {
                              "type": "boolean",
                              "description": "True when they may change the project's steps."
                            },
                            "archive": {
                              "type": "boolean",
                              "description": "True when they may archive the project."
                            },
                            "restore": {
                              "type": "boolean",
                              "description": "True when they may bring the project back from the archive."
                            },
                            "delete": {
                              "type": "boolean",
                              "description": "True when they may delete the project."
                            },
                            "transferOwnership": {
                              "type": "boolean",
                              "description": "True when they may hand the project to another person and leave it."
                            },
                            "rename": {
                              "type": "boolean",
                              "description": "True when they may rename the project."
                            },
                            "changePhoto": {
                              "type": "boolean",
                              "description": "True when they may change the project's photo."
                            },
                            "leave": {
                              "type": "boolean",
                              "description": "True when they may leave the project."
                            }
                          },
                          "required": [
                            "invite",
                            "managePeople",
                            "changeRoles",
                            "removePeople",
                            "editLists",
                            "archive",
                            "restore",
                            "delete",
                            "transferOwnership",
                            "rename",
                            "changePhoto",
                            "leave"
                          ],
                          "additionalProperties": false,
                          "description": "What the key's person may do with the project now."
                        },
                        "title": {
                          "type": "string",
                          "description": "The project's name."
                        },
                        "lastActivityAt": {
                          "type": "string",
                          "description": "When something last happened in the project that the key's person sees: a chat message or a card change."
                        },
                        "isOwner": {
                          "type": "boolean",
                          "description": "True when the key's person owns the project."
                        },
                        "ownerName": {
                          "type": "string",
                          "description": "The owner's name."
                        },
                        "memberCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many people the project has."
                        },
                        "members": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "firstName": {
                                "type": "string",
                                "description": "The person's first name."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "id",
                              "initials"
                            ],
                            "additionalProperties": false
                          },
                          "description": "A few of the project's people, for its avatars."
                        },
                        "viewerRole": {
                          "type": "string",
                          "enum": [
                            "owner",
                            "admin",
                            "member",
                            "collaborator"
                          ],
                          "description": "The key's person's role in the project."
                        },
                        "photo": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "version"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The project's photo, or null when it has none."
                        },
                        "dueTodayCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Open cards due today."
                        },
                        "closedCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards on the project's last step, archived ones included."
                        },
                        "openCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards neither archived nor on the project's last step."
                        },
                        "offerTranslation": {
                          "type": "object",
                          "properties": {
                            "languages": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64
                              },
                              "description": "The languages those cards are written in."
                            },
                            "target": {
                              "type": "string",
                              "description": "The key's person's language, which they would be translated into."
                            }
                          },
                          "required": [
                            "languages",
                            "target"
                          ],
                          "additionalProperties": false,
                          "description": "Present while Werk offers the key's person to translate the project's cards that others wrote in other languages."
                        },
                        "currentOpenCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The project's open cards, as its card list counts them."
                        },
                        "projectConfigVersion": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                        }
                      },
                      "required": [
                        "color",
                        "highlighted",
                        "appearanceRevision",
                        "id",
                        "archived",
                        "personal",
                        "title",
                        "lastActivityAt",
                        "isOwner",
                        "ownerName",
                        "viewerRole",
                        "photo",
                        "dueTodayCount",
                        "closedCardCount",
                        "openCardCount"
                      ],
                      "additionalProperties": false,
                      "description": "The project after the change, as the key's person sees it in their list."
                    },
                    "configVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "description": "The project's settings version after the change."
                    }
                  },
                  "required": [
                    "conversation",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversation": {
                    "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                    "color": "turquoise",
                    "highlighted": false,
                    "appearanceRevision": 1,
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "listPosition": 0,
                    "peopleVersion": 3,
                    "statusLine": "#12 Replace the leaking sink faucet is waiting for parts; two more cards are in progress.",
                    "statusLineAt": "2026-11-21T13:40:00.000Z",
                    "archived": false,
                    "personal": false,
                    "capabilities": {
                      "invite": true,
                      "managePeople": true,
                      "changeRoles": true,
                      "removePeople": true,
                      "editLists": true,
                      "archive": true,
                      "restore": false,
                      "delete": true,
                      "transferOwnership": true,
                      "rename": true,
                      "changePhoto": true,
                      "leave": true
                    },
                    "title": "Harbor Street kitchen and bath",
                    "lastActivityAt": "2026-11-21T13:35:00.000Z",
                    "isOwner": true,
                    "ownerName": "Maya Chen",
                    "memberCount": 3,
                    "members": [
                      {
                        "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "firstName": "Maya",
                        "initials": "MC"
                      },
                      {
                        "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "firstName": "Tom",
                        "initials": "TO"
                      },
                      {
                        "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                        "firstName": "Lucia",
                        "initials": "LF"
                      }
                    ],
                    "viewerRole": "owner",
                    "photo": {
                      "version": 2
                    },
                    "dueTodayCount": 0,
                    "closedCardCount": 4,
                    "openCardCount": 3,
                    "currentOpenCardCount": 3,
                    "projectConfigVersion": 7
                  },
                  "configVersion": 7
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_name",
              "invalid_project_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "reserved_project_name",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId",
        "tags": [
          "projects"
        ],
        "summary": "Get a project",
        "description": "One project, as the key's person's project list shows it.\n\nIt holds the project's name, people, counts of cards, Werk's line on how it is going, and what the key's person may do with it.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The project.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversation": {
                      "type": "object",
                      "properties": {
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id."
                        },
                        "color": {
                          "type": "string",
                          "enum": [
                            "pink",
                            "tangerine",
                            "yellow",
                            "green",
                            "turquoise",
                            "sky",
                            "blue",
                            "violet"
                          ],
                          "description": "The color the key's person sees the project in."
                        },
                        "highlighted": {
                          "type": "boolean",
                          "description": "True when the key's person marked the project to stand out in their list."
                        },
                        "appearanceRevision": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "Grows with each change to the key's person's color or mark for the project."
                        },
                        "id": {
                          "type": "string",
                          "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                        },
                        "listPosition": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The key's person's own place for the project in their list, or null while they never ordered it."
                        },
                        "peopleVersion": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's people, which changes whenever its people do."
                        },
                        "statusLine": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "One line Werk writes from the project's cards on how the project is going, or null before there is one."
                        },
                        "statusLineAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When that line was written."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the project is archived."
                        },
                        "personal": {
                          "default": false,
                          "type": "boolean",
                          "description": "True for the key's person's own project, My Werk, which nobody else joins."
                        },
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "invite": {
                              "type": "boolean",
                              "description": "True when the key's person may invite people to the project."
                            },
                            "managePeople": {
                              "type": "boolean",
                              "description": "True when they may manage the project's people."
                            },
                            "changeRoles": {
                              "type": "boolean",
                              "description": "True when they may make a person an admin or a member."
                            },
                            "removePeople": {
                              "type": "boolean",
                              "description": "True when they may remove people from the project."
                            },
                            "editLists": {
                              "type": "boolean",
                              "description": "True when they may change the project's steps."
                            },
                            "archive": {
                              "type": "boolean",
                              "description": "True when they may archive the project."
                            },
                            "restore": {
                              "type": "boolean",
                              "description": "True when they may bring the project back from the archive."
                            },
                            "delete": {
                              "type": "boolean",
                              "description": "True when they may delete the project."
                            },
                            "transferOwnership": {
                              "type": "boolean",
                              "description": "True when they may hand the project to another person and leave it."
                            },
                            "rename": {
                              "type": "boolean",
                              "description": "True when they may rename the project."
                            },
                            "changePhoto": {
                              "type": "boolean",
                              "description": "True when they may change the project's photo."
                            },
                            "leave": {
                              "type": "boolean",
                              "description": "True when they may leave the project."
                            }
                          },
                          "required": [
                            "invite",
                            "managePeople",
                            "changeRoles",
                            "removePeople",
                            "editLists",
                            "archive",
                            "restore",
                            "delete",
                            "transferOwnership",
                            "rename",
                            "changePhoto",
                            "leave"
                          ],
                          "additionalProperties": false,
                          "description": "What the key's person may do with the project now."
                        },
                        "title": {
                          "type": "string",
                          "description": "The project's name."
                        },
                        "lastActivityAt": {
                          "type": "string",
                          "description": "When something last happened in the project that the key's person sees: a chat message or a card change."
                        },
                        "isOwner": {
                          "type": "boolean",
                          "description": "True when the key's person owns the project."
                        },
                        "ownerName": {
                          "type": "string",
                          "description": "The owner's name."
                        },
                        "memberCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many people the project has."
                        },
                        "members": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "firstName": {
                                "type": "string",
                                "description": "The person's first name."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "id",
                              "initials"
                            ],
                            "additionalProperties": false
                          },
                          "description": "A few of the project's people, for its avatars."
                        },
                        "viewerRole": {
                          "type": "string",
                          "enum": [
                            "owner",
                            "admin",
                            "member",
                            "collaborator"
                          ],
                          "description": "The key's person's role in the project."
                        },
                        "photo": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "version"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The project's photo, or null when it has none."
                        },
                        "dueTodayCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Open cards due today."
                        },
                        "closedCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards on the project's last step, archived ones included."
                        },
                        "openCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards neither archived nor on the project's last step."
                        },
                        "offerTranslation": {
                          "type": "object",
                          "properties": {
                            "languages": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64
                              },
                              "description": "The languages those cards are written in."
                            },
                            "target": {
                              "type": "string",
                              "description": "The key's person's language, which they would be translated into."
                            }
                          },
                          "required": [
                            "languages",
                            "target"
                          ],
                          "additionalProperties": false,
                          "description": "Present while Werk offers the key's person to translate the project's cards that others wrote in other languages."
                        },
                        "currentOpenCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The project's open cards, as its card list counts them."
                        },
                        "projectConfigVersion": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                        }
                      },
                      "required": [
                        "color",
                        "highlighted",
                        "appearanceRevision",
                        "id",
                        "archived",
                        "personal",
                        "title",
                        "lastActivityAt",
                        "isOwner",
                        "ownerName",
                        "viewerRole",
                        "photo",
                        "dueTodayCount",
                        "closedCardCount",
                        "openCardCount"
                      ],
                      "additionalProperties": false,
                      "description": "The project."
                    }
                  },
                  "required": [
                    "conversation"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversation": {
                    "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                    "color": "turquoise",
                    "highlighted": false,
                    "appearanceRevision": 1,
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "listPosition": 0,
                    "peopleVersion": 3,
                    "statusLine": "#12 Replace the leaking sink faucet is waiting for parts; two more cards are in progress.",
                    "statusLineAt": "2026-11-21T13:40:00.000Z",
                    "archived": false,
                    "personal": false,
                    "capabilities": {
                      "invite": true,
                      "managePeople": true,
                      "changeRoles": true,
                      "removePeople": true,
                      "editLists": true,
                      "archive": true,
                      "restore": false,
                      "delete": true,
                      "transferOwnership": true,
                      "rename": true,
                      "changePhoto": true,
                      "leave": true
                    },
                    "title": "Harbor Street kitchen",
                    "lastActivityAt": "2026-11-21T13:35:00.000Z",
                    "isOwner": true,
                    "ownerName": "Maya Chen",
                    "memberCount": 3,
                    "members": [
                      {
                        "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "firstName": "Maya",
                        "initials": "MC"
                      },
                      {
                        "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "firstName": "Tom",
                        "initials": "TO"
                      },
                      {
                        "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                        "firstName": "Lucia",
                        "initials": "LF"
                      }
                    ],
                    "viewerRole": "owner",
                    "photo": {
                      "version": 2
                    },
                    "dueTodayCount": 0,
                    "closedCardCount": 4,
                    "openCardCount": 3,
                    "currentOpenCardCount": 3,
                    "projectConfigVersion": 6
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/photo": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/photo",
        "tags": [
          "projects"
        ],
        "summary": "Change a project's photo",
        "description": "Sets the project's photo, from a JPEG sent as the body or from an upload made first with POST /assets.\n\nThe project's owner and admins may change it. The photo must be square and within the project photo's size.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "An id the caller makes for this request; sent again with it, the request changes nothing twice.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b03"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "image/jpeg": {
              "schema": {
                "type": "string",
                "contentMediaType": "image/jpeg"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "assetId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "A photo uploaded first with POST /assets, made the project's new photo."
                  }
                },
                "required": [
                  "assetId"
                ],
                "additionalProperties": false
              },
              "example": {
                "assetId": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project's new photo.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "photo": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                        }
                      },
                      "required": [
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The project's photo after the change."
                    }
                  },
                  "required": [
                    "photo"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "photo": {
                    "version": 3
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_idempotency_key",
              "invalid_media",
              "unsupported_media_type",
              "photo_side_too_large"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "idempotency_conflict",
              "request_conflict"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/photo",
        "tags": [
          "projects"
        ],
        "summary": "Remove a project's photo",
        "description": "Takes the project's photo off.\n\nThe project's owner and admins may remove it.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "An id the caller makes for this request; sent again with it, the request changes nothing twice.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b04"
          }
        ],
        "responses": {
          "204": {
            "description": "The photo is off."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_idempotency_key"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "idempotency_conflict",
              "request_conflict"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/photo",
        "tags": [
          "projects"
        ],
        "summary": "Get a project's photo",
        "description": "The project's photo, as a JPEG.\n\nWith If-None-Match holding the photo's current ETag, the answer is 304 with no body.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "version",
            "in": "query",
            "required": false,
            "description": "The photo's version as last read; when it is no longer current, the photo is not found.",
            "schema": {
              "type": "string"
            },
            "example": "2"
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "The ETag of a copy already held; when it is current, the answer is 304.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The photo, with its version as its ETag.",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "image/jpeg"
                }
              }
            }
          },
          "304": {
            "description": "The copy held is current."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_photo_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/steps": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/steps",
        "tags": [
          "projects"
        ],
        "summary": "List a project's steps",
        "description": "The project's steps in order, each with how many cards are on it.\n\nA card's step is one of these; the first step means open and the last means done.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The project's steps.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "capabilities": {
                      "type": "object",
                      "properties": {
                        "invite": {
                          "type": "boolean",
                          "description": "True when the key's person may invite people to the project."
                        },
                        "managePeople": {
                          "type": "boolean",
                          "description": "True when they may manage the project's people."
                        },
                        "changeRoles": {
                          "type": "boolean",
                          "description": "True when they may make a person an admin or a member."
                        },
                        "removePeople": {
                          "type": "boolean",
                          "description": "True when they may remove people from the project."
                        },
                        "editLists": {
                          "type": "boolean",
                          "description": "True when they may change the project's steps."
                        },
                        "archive": {
                          "type": "boolean",
                          "description": "True when they may archive the project."
                        },
                        "restore": {
                          "type": "boolean",
                          "description": "True when they may bring the project back from the archive."
                        },
                        "delete": {
                          "type": "boolean",
                          "description": "True when they may delete the project."
                        },
                        "transferOwnership": {
                          "type": "boolean",
                          "description": "True when they may hand the project to another person and leave it."
                        },
                        "rename": {
                          "type": "boolean",
                          "description": "True when they may rename the project."
                        },
                        "changePhoto": {
                          "type": "boolean",
                          "description": "True when they may change the project's photo."
                        },
                        "leave": {
                          "type": "boolean",
                          "description": "True when they may leave the project."
                        }
                      },
                      "required": [
                        "invite",
                        "managePeople",
                        "changeRoles",
                        "removePeople",
                        "editLists",
                        "archive",
                        "restore",
                        "delete",
                        "transferOwnership",
                        "rename",
                        "changePhoto",
                        "leave"
                      ],
                      "additionalProperties": false,
                      "description": "What the key's person may do with the project now."
                    },
                    "configVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                    },
                    "steps": {
                      "minItems": 2,
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "maxLength": 64,
                            "pattern": "^[a-z][a-z0-9_]*$",
                            "description": "The step's id; a card's step names it as stepId."
                          },
                          "label": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 60,
                            "description": "The step's name, in the reader's language when it is one of Werk's own words."
                          },
                          "labelLanguage": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 64,
                            "description": "The language a name the project wrote is written in; absent for one of Werk's own words."
                          },
                          "labelTranslation": {
                            "type": "object",
                            "properties": {
                              "language": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The reader's language the text is translated into."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "ready",
                                  "pending",
                                  "failed",
                                  "paused"
                                ],
                                "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                              },
                              "text": {
                                "type": "string",
                                "description": "The translated text, present once ready."
                              }
                            },
                            "required": [
                              "language",
                              "state"
                            ],
                            "additionalProperties": false,
                            "description": "A name the project wrote, in the reader's language, when it is written in another."
                          },
                          "labelSource": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "locale_key",
                                    "description": "locale_key for one of Werk's own words, text for a name as written."
                                  },
                                  "key": {
                                    "type": "string",
                                    "enum": [
                                      "project_steps.steps.open",
                                      "project_steps.steps.in_progress",
                                      "project_steps.steps.waiting_parts",
                                      "project_steps.steps.done",
                                      "project_steps.steps.paid",
                                      "project_steps.steps.in_review"
                                    ],
                                    "description": "Which of Werk's own words names the step."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "key"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "text",
                                    "description": "locale_key for one of Werk's own words, text for a name as written."
                                  },
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 60,
                                    "description": "The name, as written."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "text"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "The name as stored: one of Werk's own words, or a name as written. A change of steps sends it back as label."
                          },
                          "bucket": {
                            "type": "string",
                            "enum": [
                              "new",
                              "in_progress",
                              "waiting",
                              "resolved",
                              "closed"
                            ],
                            "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 99,
                            "description": "The step's place among the project's steps, from 0."
                          },
                          "cardCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many cards are on the step."
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "labelSource",
                          "bucket",
                          "position",
                          "cardCount"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The project's steps, in order."
                    }
                  },
                  "required": [
                    "configVersion",
                    "steps"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "capabilities": {
                    "invite": true,
                    "managePeople": true,
                    "changeRoles": true,
                    "removePeople": true,
                    "editLists": true,
                    "archive": true,
                    "restore": false,
                    "delete": true,
                    "transferOwnership": true,
                    "rename": true,
                    "changePhoto": true,
                    "leave": true
                  },
                  "configVersion": 6,
                  "steps": [
                    {
                      "id": "open",
                      "label": "Pending",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.open"
                      },
                      "bucket": "new",
                      "position": 0,
                      "cardCount": 1
                    },
                    {
                      "id": "in_progress",
                      "label": "In progress",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.in_progress"
                      },
                      "bucket": "in_progress",
                      "position": 1,
                      "cardCount": 1
                    },
                    {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.waiting_parts"
                      },
                      "bucket": "waiting",
                      "position": 2,
                      "cardCount": 1
                    },
                    {
                      "id": "done",
                      "label": "Done",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.done"
                      },
                      "bucket": "resolved",
                      "position": 3,
                      "cardCount": 3
                    },
                    {
                      "id": "paid",
                      "label": "Paid",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.paid"
                      },
                      "bucket": "closed",
                      "position": 4,
                      "cardCount": 1
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/steps",
        "tags": [
          "projects"
        ],
        "summary": "Change a project's steps",
        "description": "Replaces the project's steps with a new list.\n\nThe project's owner and admins may change them. A card on a removed step moves to a step beside it, and each move is one entry in that card's history. Refused when the project's settings changed since they were read.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedConfigVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The project's projectConfigVersion as last read; when its settings changed since, the change is refused."
                  },
                  "steps": {
                    "minItems": 2,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "maxLength": 64,
                          "pattern": "^[a-z][a-z0-9_]*$",
                          "description": "The step's id: an existing step's id keeps that step and its cards, a new id adds a step."
                        },
                        "label": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "locale_key",
                                  "description": "locale_key for one of Werk's own words, written in each reader's language; text for a name as written."
                                },
                                "key": {
                                  "type": "string",
                                  "enum": [
                                    "project_steps.steps.open",
                                    "project_steps.steps.in_progress",
                                    "project_steps.steps.waiting_parts",
                                    "project_steps.steps.done",
                                    "project_steps.steps.paid",
                                    "project_steps.steps.in_review"
                                  ],
                                  "description": "Which of Werk's own words names the step."
                                }
                              },
                              "required": [
                                "kind",
                                "key"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "text",
                                  "description": "locale_key for one of Werk's own words, written in each reader's language; text for a name as written."
                                },
                                "text": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 60,
                                  "description": "The step's name, as written."
                                }
                              },
                              "required": [
                                "kind",
                                "text"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "The step's name: one of Werk's own words, or a name as written."
                        },
                        "bucket": {
                          "type": "string",
                          "enum": [
                            "new",
                            "in_progress",
                            "waiting",
                            "resolved",
                            "closed"
                          ],
                          "description": "The kind of step: the first step must be new, in_progress or waiting, and the last resolved or closed."
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "bucket"
                      ],
                      "additionalProperties": false
                    },
                    "description": "The project's whole new list of steps, in order. A step left out is removed, and its cards move to the step before it, or after it when it was the first."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedConfigVersion",
                  "steps"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b05",
                "expectedConfigVersion": 6,
                "steps": [
                  {
                    "id": "open",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.open"
                    },
                    "bucket": "new"
                  },
                  {
                    "id": "in_progress",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.in_progress"
                    },
                    "bucket": "in_progress"
                  },
                  {
                    "id": "waiting_parts",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.waiting_parts"
                    },
                    "bucket": "waiting"
                  },
                  {
                    "id": "done",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.done"
                    },
                    "bucket": "resolved"
                  },
                  {
                    "id": "paid",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.paid"
                    },
                    "bucket": "closed"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project's steps after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "capabilities": {
                      "type": "object",
                      "properties": {
                        "invite": {
                          "type": "boolean",
                          "description": "True when the key's person may invite people to the project."
                        },
                        "managePeople": {
                          "type": "boolean",
                          "description": "True when they may manage the project's people."
                        },
                        "changeRoles": {
                          "type": "boolean",
                          "description": "True when they may make a person an admin or a member."
                        },
                        "removePeople": {
                          "type": "boolean",
                          "description": "True when they may remove people from the project."
                        },
                        "editLists": {
                          "type": "boolean",
                          "description": "True when they may change the project's steps."
                        },
                        "archive": {
                          "type": "boolean",
                          "description": "True when they may archive the project."
                        },
                        "restore": {
                          "type": "boolean",
                          "description": "True when they may bring the project back from the archive."
                        },
                        "delete": {
                          "type": "boolean",
                          "description": "True when they may delete the project."
                        },
                        "transferOwnership": {
                          "type": "boolean",
                          "description": "True when they may hand the project to another person and leave it."
                        },
                        "rename": {
                          "type": "boolean",
                          "description": "True when they may rename the project."
                        },
                        "changePhoto": {
                          "type": "boolean",
                          "description": "True when they may change the project's photo."
                        },
                        "leave": {
                          "type": "boolean",
                          "description": "True when they may leave the project."
                        }
                      },
                      "required": [
                        "invite",
                        "managePeople",
                        "changeRoles",
                        "removePeople",
                        "editLists",
                        "archive",
                        "restore",
                        "delete",
                        "transferOwnership",
                        "rename",
                        "changePhoto",
                        "leave"
                      ],
                      "additionalProperties": false,
                      "description": "What the key's person may do with the project now."
                    },
                    "configVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                    },
                    "steps": {
                      "minItems": 2,
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "maxLength": 64,
                            "pattern": "^[a-z][a-z0-9_]*$",
                            "description": "The step's id; a card's step names it as stepId."
                          },
                          "label": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 60,
                            "description": "The step's name, in the reader's language when it is one of Werk's own words."
                          },
                          "labelLanguage": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 64,
                            "description": "The language a name the project wrote is written in; absent for one of Werk's own words."
                          },
                          "labelTranslation": {
                            "type": "object",
                            "properties": {
                              "language": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The reader's language the text is translated into."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "ready",
                                  "pending",
                                  "failed",
                                  "paused"
                                ],
                                "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                              },
                              "text": {
                                "type": "string",
                                "description": "The translated text, present once ready."
                              }
                            },
                            "required": [
                              "language",
                              "state"
                            ],
                            "additionalProperties": false,
                            "description": "A name the project wrote, in the reader's language, when it is written in another."
                          },
                          "labelSource": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "locale_key",
                                    "description": "locale_key for one of Werk's own words, text for a name as written."
                                  },
                                  "key": {
                                    "type": "string",
                                    "enum": [
                                      "project_steps.steps.open",
                                      "project_steps.steps.in_progress",
                                      "project_steps.steps.waiting_parts",
                                      "project_steps.steps.done",
                                      "project_steps.steps.paid",
                                      "project_steps.steps.in_review"
                                    ],
                                    "description": "Which of Werk's own words names the step."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "key"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "text",
                                    "description": "locale_key for one of Werk's own words, text for a name as written."
                                  },
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 60,
                                    "description": "The name, as written."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "text"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "The name as stored: one of Werk's own words, or a name as written. A change of steps sends it back as label."
                          },
                          "bucket": {
                            "type": "string",
                            "enum": [
                              "new",
                              "in_progress",
                              "waiting",
                              "resolved",
                              "closed"
                            ],
                            "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                          },
                          "position": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 99,
                            "description": "The step's place among the project's steps, from 0."
                          },
                          "cardCount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many cards are on the step."
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "labelSource",
                          "bucket",
                          "position",
                          "cardCount"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The project's steps, in order."
                    }
                  },
                  "required": [
                    "configVersion",
                    "steps"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "capabilities": {
                    "invite": true,
                    "managePeople": true,
                    "changeRoles": true,
                    "removePeople": true,
                    "editLists": true,
                    "archive": true,
                    "restore": false,
                    "delete": true,
                    "transferOwnership": true,
                    "rename": true,
                    "changePhoto": true,
                    "leave": true
                  },
                  "configVersion": 7,
                  "steps": [
                    {
                      "id": "open",
                      "label": "Pending",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.open"
                      },
                      "bucket": "new",
                      "position": 0,
                      "cardCount": 1
                    },
                    {
                      "id": "in_progress",
                      "label": "In progress",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.in_progress"
                      },
                      "bucket": "in_progress",
                      "position": 1,
                      "cardCount": 1
                    },
                    {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.waiting_parts"
                      },
                      "bucket": "waiting",
                      "position": 2,
                      "cardCount": 1
                    },
                    {
                      "id": "done",
                      "label": "Done",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.done"
                      },
                      "bucket": "resolved",
                      "position": 3,
                      "cardCount": 3
                    },
                    {
                      "id": "paid",
                      "label": "Paid",
                      "labelSource": {
                        "kind": "locale_key",
                        "key": "project_steps.steps.paid"
                      },
                      "bucket": "closed",
                      "position": 4,
                      "cardCount": 1
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "too_few_project_steps",
              "too_many_project_steps",
              "duplicate_project_step",
              "project_first_step_not_open",
              "project_last_step_not_finished",
              "invalid_project_step_label",
              "invalid_project_request",
              "invalid_project_steps"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/archive": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/archive",
        "tags": [
          "projects"
        ],
        "summary": "Archive a project",
        "description": "Archives the project: it leaves the project list and takes no changes until it is brought back.\n\nOnly the project's owner may archive it, and My Werk is never archived. Its scheduled reminders are cancelled. Refused when the project's settings changed since they were read.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedConfigVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The project's projectConfigVersion as last read; when its settings changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedConfigVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b06",
                "expectedConfigVersion": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversation": {
                      "type": "object",
                      "properties": {
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id."
                        },
                        "color": {
                          "type": "string",
                          "enum": [
                            "pink",
                            "tangerine",
                            "yellow",
                            "green",
                            "turquoise",
                            "sky",
                            "blue",
                            "violet"
                          ],
                          "description": "The color the key's person sees the project in."
                        },
                        "highlighted": {
                          "type": "boolean",
                          "description": "True when the key's person marked the project to stand out in their list."
                        },
                        "appearanceRevision": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "Grows with each change to the key's person's color or mark for the project."
                        },
                        "id": {
                          "type": "string",
                          "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                        },
                        "listPosition": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The key's person's own place for the project in their list, or null while they never ordered it."
                        },
                        "peopleVersion": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's people, which changes whenever its people do."
                        },
                        "statusLine": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "One line Werk writes from the project's cards on how the project is going, or null before there is one."
                        },
                        "statusLineAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When that line was written."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the project is archived."
                        },
                        "personal": {
                          "default": false,
                          "type": "boolean",
                          "description": "True for the key's person's own project, My Werk, which nobody else joins."
                        },
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "invite": {
                              "type": "boolean",
                              "description": "True when the key's person may invite people to the project."
                            },
                            "managePeople": {
                              "type": "boolean",
                              "description": "True when they may manage the project's people."
                            },
                            "changeRoles": {
                              "type": "boolean",
                              "description": "True when they may make a person an admin or a member."
                            },
                            "removePeople": {
                              "type": "boolean",
                              "description": "True when they may remove people from the project."
                            },
                            "editLists": {
                              "type": "boolean",
                              "description": "True when they may change the project's steps."
                            },
                            "archive": {
                              "type": "boolean",
                              "description": "True when they may archive the project."
                            },
                            "restore": {
                              "type": "boolean",
                              "description": "True when they may bring the project back from the archive."
                            },
                            "delete": {
                              "type": "boolean",
                              "description": "True when they may delete the project."
                            },
                            "transferOwnership": {
                              "type": "boolean",
                              "description": "True when they may hand the project to another person and leave it."
                            },
                            "rename": {
                              "type": "boolean",
                              "description": "True when they may rename the project."
                            },
                            "changePhoto": {
                              "type": "boolean",
                              "description": "True when they may change the project's photo."
                            },
                            "leave": {
                              "type": "boolean",
                              "description": "True when they may leave the project."
                            }
                          },
                          "required": [
                            "invite",
                            "managePeople",
                            "changeRoles",
                            "removePeople",
                            "editLists",
                            "archive",
                            "restore",
                            "delete",
                            "transferOwnership",
                            "rename",
                            "changePhoto",
                            "leave"
                          ],
                          "additionalProperties": false,
                          "description": "What the key's person may do with the project now."
                        },
                        "title": {
                          "type": "string",
                          "description": "The project's name."
                        },
                        "lastActivityAt": {
                          "type": "string",
                          "description": "When something last happened in the project that the key's person sees: a chat message or a card change."
                        },
                        "isOwner": {
                          "type": "boolean",
                          "description": "True when the key's person owns the project."
                        },
                        "ownerName": {
                          "type": "string",
                          "description": "The owner's name."
                        },
                        "memberCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many people the project has."
                        },
                        "members": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "firstName": {
                                "type": "string",
                                "description": "The person's first name."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "id",
                              "initials"
                            ],
                            "additionalProperties": false
                          },
                          "description": "A few of the project's people, for its avatars."
                        },
                        "viewerRole": {
                          "type": "string",
                          "enum": [
                            "owner",
                            "admin",
                            "member",
                            "collaborator"
                          ],
                          "description": "The key's person's role in the project."
                        },
                        "photo": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "version"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The project's photo, or null when it has none."
                        },
                        "dueTodayCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Open cards due today."
                        },
                        "closedCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards on the project's last step, archived ones included."
                        },
                        "openCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards neither archived nor on the project's last step."
                        },
                        "offerTranslation": {
                          "type": "object",
                          "properties": {
                            "languages": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64
                              },
                              "description": "The languages those cards are written in."
                            },
                            "target": {
                              "type": "string",
                              "description": "The key's person's language, which they would be translated into."
                            }
                          },
                          "required": [
                            "languages",
                            "target"
                          ],
                          "additionalProperties": false,
                          "description": "Present while Werk offers the key's person to translate the project's cards that others wrote in other languages."
                        },
                        "currentOpenCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The project's open cards, as its card list counts them."
                        },
                        "projectConfigVersion": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                        }
                      },
                      "required": [
                        "color",
                        "highlighted",
                        "appearanceRevision",
                        "id",
                        "archived",
                        "personal",
                        "title",
                        "lastActivityAt",
                        "isOwner",
                        "ownerName",
                        "viewerRole",
                        "photo",
                        "dueTodayCount",
                        "closedCardCount",
                        "openCardCount"
                      ],
                      "additionalProperties": false,
                      "description": "The project after the change, as the key's person sees it in their list."
                    },
                    "configVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "description": "The project's settings version after the change."
                    }
                  },
                  "required": [
                    "conversation",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversation": {
                    "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                    "color": "turquoise",
                    "highlighted": false,
                    "appearanceRevision": 1,
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "listPosition": 0,
                    "peopleVersion": 3,
                    "statusLine": "#12 Replace the leaking sink faucet is waiting for parts; two more cards are in progress.",
                    "statusLineAt": "2026-11-21T13:40:00.000Z",
                    "archived": true,
                    "personal": false,
                    "capabilities": {
                      "invite": false,
                      "managePeople": false,
                      "changeRoles": false,
                      "removePeople": false,
                      "editLists": false,
                      "archive": false,
                      "restore": true,
                      "delete": true,
                      "transferOwnership": true,
                      "rename": true,
                      "changePhoto": true,
                      "leave": true
                    },
                    "title": "Harbor Street kitchen",
                    "lastActivityAt": "2026-11-21T13:35:00.000Z",
                    "isOwner": true,
                    "ownerName": "Maya Chen",
                    "memberCount": 3,
                    "members": [
                      {
                        "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "firstName": "Maya",
                        "initials": "MC"
                      },
                      {
                        "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "firstName": "Tom",
                        "initials": "TO"
                      },
                      {
                        "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                        "firstName": "Lucia",
                        "initials": "LF"
                      }
                    ],
                    "viewerRole": "owner",
                    "photo": {
                      "version": 2
                    },
                    "dueTodayCount": 0,
                    "closedCardCount": 4,
                    "openCardCount": 3,
                    "currentOpenCardCount": 3,
                    "projectConfigVersion": 7
                  },
                  "configVersion": 7
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "project_archived",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/unarchive": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/unarchive",
        "tags": [
          "projects"
        ],
        "summary": "Unarchive a project",
        "description": "Brings an archived project back into use.\n\nOnly the project's owner may do it. Reminders cancelled by the archive stay cancelled. Refused when the project's settings changed since they were read.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedConfigVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The project's projectConfigVersion as last read; when its settings changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedConfigVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b07",
                "expectedConfigVersion": 7
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversation": {
                      "type": "object",
                      "properties": {
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id."
                        },
                        "color": {
                          "type": "string",
                          "enum": [
                            "pink",
                            "tangerine",
                            "yellow",
                            "green",
                            "turquoise",
                            "sky",
                            "blue",
                            "violet"
                          ],
                          "description": "The color the key's person sees the project in."
                        },
                        "highlighted": {
                          "type": "boolean",
                          "description": "True when the key's person marked the project to stand out in their list."
                        },
                        "appearanceRevision": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "Grows with each change to the key's person's color or mark for the project."
                        },
                        "id": {
                          "type": "string",
                          "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                        },
                        "listPosition": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The key's person's own place for the project in their list, or null while they never ordered it."
                        },
                        "peopleVersion": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's people, which changes whenever its people do."
                        },
                        "statusLine": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "One line Werk writes from the project's cards on how the project is going, or null before there is one."
                        },
                        "statusLineAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When that line was written."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the project is archived."
                        },
                        "personal": {
                          "default": false,
                          "type": "boolean",
                          "description": "True for the key's person's own project, My Werk, which nobody else joins."
                        },
                        "capabilities": {
                          "type": "object",
                          "properties": {
                            "invite": {
                              "type": "boolean",
                              "description": "True when the key's person may invite people to the project."
                            },
                            "managePeople": {
                              "type": "boolean",
                              "description": "True when they may manage the project's people."
                            },
                            "changeRoles": {
                              "type": "boolean",
                              "description": "True when they may make a person an admin or a member."
                            },
                            "removePeople": {
                              "type": "boolean",
                              "description": "True when they may remove people from the project."
                            },
                            "editLists": {
                              "type": "boolean",
                              "description": "True when they may change the project's steps."
                            },
                            "archive": {
                              "type": "boolean",
                              "description": "True when they may archive the project."
                            },
                            "restore": {
                              "type": "boolean",
                              "description": "True when they may bring the project back from the archive."
                            },
                            "delete": {
                              "type": "boolean",
                              "description": "True when they may delete the project."
                            },
                            "transferOwnership": {
                              "type": "boolean",
                              "description": "True when they may hand the project to another person and leave it."
                            },
                            "rename": {
                              "type": "boolean",
                              "description": "True when they may rename the project."
                            },
                            "changePhoto": {
                              "type": "boolean",
                              "description": "True when they may change the project's photo."
                            },
                            "leave": {
                              "type": "boolean",
                              "description": "True when they may leave the project."
                            }
                          },
                          "required": [
                            "invite",
                            "managePeople",
                            "changeRoles",
                            "removePeople",
                            "editLists",
                            "archive",
                            "restore",
                            "delete",
                            "transferOwnership",
                            "rename",
                            "changePhoto",
                            "leave"
                          ],
                          "additionalProperties": false,
                          "description": "What the key's person may do with the project now."
                        },
                        "title": {
                          "type": "string",
                          "description": "The project's name."
                        },
                        "lastActivityAt": {
                          "type": "string",
                          "description": "When something last happened in the project that the key's person sees: a chat message or a card change."
                        },
                        "isOwner": {
                          "type": "boolean",
                          "description": "True when the key's person owns the project."
                        },
                        "ownerName": {
                          "type": "string",
                          "description": "The owner's name."
                        },
                        "memberCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many people the project has."
                        },
                        "members": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "firstName": {
                                "type": "string",
                                "description": "The person's first name."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "id",
                              "initials"
                            ],
                            "additionalProperties": false
                          },
                          "description": "A few of the project's people, for its avatars."
                        },
                        "viewerRole": {
                          "type": "string",
                          "enum": [
                            "owner",
                            "admin",
                            "member",
                            "collaborator"
                          ],
                          "description": "The key's person's role in the project."
                        },
                        "photo": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "version"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The project's photo, or null when it has none."
                        },
                        "dueTodayCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Open cards due today."
                        },
                        "closedCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards on the project's last step, archived ones included."
                        },
                        "openCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Cards neither archived nor on the project's last step."
                        },
                        "offerTranslation": {
                          "type": "object",
                          "properties": {
                            "languages": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64
                              },
                              "description": "The languages those cards are written in."
                            },
                            "target": {
                              "type": "string",
                              "description": "The key's person's language, which they would be translated into."
                            }
                          },
                          "required": [
                            "languages",
                            "target"
                          ],
                          "additionalProperties": false,
                          "description": "Present while Werk offers the key's person to translate the project's cards that others wrote in other languages."
                        },
                        "currentOpenCardCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The project's open cards, as its card list counts them."
                        },
                        "projectConfigVersion": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                        }
                      },
                      "required": [
                        "color",
                        "highlighted",
                        "appearanceRevision",
                        "id",
                        "archived",
                        "personal",
                        "title",
                        "lastActivityAt",
                        "isOwner",
                        "ownerName",
                        "viewerRole",
                        "photo",
                        "dueTodayCount",
                        "closedCardCount",
                        "openCardCount"
                      ],
                      "additionalProperties": false,
                      "description": "The project after the change, as the key's person sees it in their list."
                    },
                    "configVersion": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "description": "The project's settings version after the change."
                    }
                  },
                  "required": [
                    "conversation",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversation": {
                    "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                    "color": "turquoise",
                    "highlighted": false,
                    "appearanceRevision": 1,
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "listPosition": 0,
                    "peopleVersion": 3,
                    "statusLine": "#12 Replace the leaking sink faucet is waiting for parts; two more cards are in progress.",
                    "statusLineAt": "2026-11-21T13:40:00.000Z",
                    "archived": false,
                    "personal": false,
                    "capabilities": {
                      "invite": true,
                      "managePeople": true,
                      "changeRoles": true,
                      "removePeople": true,
                      "editLists": true,
                      "archive": true,
                      "restore": false,
                      "delete": true,
                      "transferOwnership": true,
                      "rename": true,
                      "changePhoto": true,
                      "leave": true
                    },
                    "title": "Harbor Street kitchen",
                    "lastActivityAt": "2026-11-21T13:35:00.000Z",
                    "isOwner": true,
                    "ownerName": "Maya Chen",
                    "memberCount": 3,
                    "members": [
                      {
                        "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "firstName": "Maya",
                        "initials": "MC"
                      },
                      {
                        "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "firstName": "Tom",
                        "initials": "TO"
                      },
                      {
                        "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                        "firstName": "Lucia",
                        "initials": "LF"
                      }
                    ],
                    "viewerRole": "owner",
                    "photo": {
                      "version": 2
                    },
                    "dueTodayCount": 0,
                    "closedCardCount": 4,
                    "openCardCount": 3,
                    "currentOpenCardCount": 3,
                    "projectConfigVersion": 8
                  },
                  "configVersion": 8
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "project_config_changed",
              "project_not_archived"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/step-templates": {
      "get": {
        "operationId": "GET /api/v1/step-templates",
        "tags": [
          "profile"
        ],
        "summary": "List step templates",
        "description": "The step templates a new project can take: Werk's own and the ones the key's person saved.\n\nWerk's own templates that the person hid are left out.",
        "x-werk-group": "read",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The templates.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "templates": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "simple",
                                  "technicians",
                                  "software",
                                  "home"
                                ]
                              },
                              {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                              }
                            ],
                            "description": "The template's id, which a new project takes as templateId."
                          },
                          "builtIn": {
                            "type": "boolean",
                            "description": "True for one of Werk's own templates, false for one the key's person saved."
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 60,
                            "description": "The template's name, in the reader's language for one of Werk's own."
                          },
                          "nameSource": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "locale_key",
                                    "description": "locale_key for one of Werk's own words, text for a name as written."
                                  },
                                  "key": {
                                    "type": "string",
                                    "enum": [
                                      "project_steps.templates.simple",
                                      "project_steps.templates.technicians",
                                      "project_steps.templates.software",
                                      "project_steps.templates.home"
                                    ],
                                    "description": "Which of Werk's own words names the template."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "key"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "text",
                                    "description": "locale_key for one of Werk's own words, text for a name as written."
                                  },
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 60,
                                    "description": "The name, as written."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "text"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "The name as stored: one of Werk's own words, or a name as written."
                          },
                          "steps": {
                            "minItems": 2,
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "maxLength": 64,
                                  "pattern": "^[a-z][a-z0-9_]*$",
                                  "description": "The step's id; a card's step names it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 60,
                                  "description": "The step's name, in the reader's language when it is one of Werk's own words."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language a name the project wrote is written in; absent for one of Werk's own words."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A name the project wrote, in the reader's language, when it is written in another."
                                },
                                "labelSource": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "locale_key",
                                          "description": "locale_key for one of Werk's own words, text for a name as written."
                                        },
                                        "key": {
                                          "type": "string",
                                          "enum": [
                                            "project_steps.steps.open",
                                            "project_steps.steps.in_progress",
                                            "project_steps.steps.waiting_parts",
                                            "project_steps.steps.done",
                                            "project_steps.steps.paid",
                                            "project_steps.steps.in_review"
                                          ],
                                          "description": "Which of Werk's own words names the step."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "key"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "text",
                                          "description": "locale_key for one of Werk's own words, text for a name as written."
                                        },
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 60,
                                          "description": "The name, as written."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "text"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ],
                                  "description": "The name as stored: one of Werk's own words, or a name as written. A change of steps sends it back as label."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "position": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 99,
                                  "description": "The step's place among the project's steps, from 0."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "labelSource",
                                "bucket",
                                "position"
                              ],
                              "additionalProperties": false
                            },
                            "description": "The template's steps, in order."
                          }
                        },
                        "required": [
                          "id",
                          "builtIn",
                          "name",
                          "nameSource",
                          "steps"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The step templates a project can start from: Werk's own and the ones the key's person saved."
                    }
                  },
                  "required": [
                    "templates"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "templates": [
                    {
                      "id": "simple",
                      "builtIn": true,
                      "name": "Simple",
                      "nameSource": {
                        "kind": "locale_key",
                        "key": "project_steps.templates.simple"
                      },
                      "steps": [
                        {
                          "id": "open",
                          "label": "Pending",
                          "labelSource": {
                            "kind": "locale_key",
                            "key": "project_steps.steps.open"
                          },
                          "bucket": "new",
                          "position": 0
                        },
                        {
                          "id": "in_progress",
                          "label": "In progress",
                          "labelSource": {
                            "kind": "locale_key",
                            "key": "project_steps.steps.in_progress"
                          },
                          "bucket": "in_progress",
                          "position": 1
                        },
                        {
                          "id": "done",
                          "label": "Done",
                          "labelSource": {
                            "kind": "locale_key",
                            "key": "project_steps.steps.done"
                          },
                          "bucket": "resolved",
                          "position": 2
                        }
                      ]
                    },
                    {
                      "id": "c1f5b9d3-8a2e-4c4a-96f8-1a7b9e3c5f97",
                      "builtIn": false,
                      "name": "Kitchen visit",
                      "nameSource": {
                        "kind": "text",
                        "text": "Kitchen visit"
                      },
                      "steps": [
                        {
                          "id": "open",
                          "label": "Pending",
                          "labelSource": {
                            "kind": "locale_key",
                            "key": "project_steps.steps.open"
                          },
                          "bucket": "new",
                          "position": 0
                        },
                        {
                          "id": "measured",
                          "label": "Measured",
                          "labelSource": {
                            "kind": "text",
                            "text": "Measured"
                          },
                          "bucket": "in_progress",
                          "position": 1
                        },
                        {
                          "id": "done",
                          "label": "Done",
                          "labelSource": {
                            "kind": "locale_key",
                            "key": "project_steps.steps.done"
                          },
                          "bucket": "resolved",
                          "position": 2
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/step-templates",
        "tags": [
          "profile"
        ],
        "summary": "Save a step template",
        "description": "Saves a list of steps as a template of the key's person's own, for their next projects.\n\nChanging a project's steps later never changes its template.",
        "x-werk-group": "create",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "description": "The template's name."
                  },
                  "steps": {
                    "minItems": 2,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "maxLength": 64,
                          "pattern": "^[a-z][a-z0-9_]*$",
                          "description": "The step's id: an existing step's id keeps that step and its cards, a new id adds a step."
                        },
                        "label": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "locale_key",
                                  "description": "locale_key for one of Werk's own words, written in each reader's language; text for a name as written."
                                },
                                "key": {
                                  "type": "string",
                                  "enum": [
                                    "project_steps.steps.open",
                                    "project_steps.steps.in_progress",
                                    "project_steps.steps.waiting_parts",
                                    "project_steps.steps.done",
                                    "project_steps.steps.paid",
                                    "project_steps.steps.in_review"
                                  ],
                                  "description": "Which of Werk's own words names the step."
                                }
                              },
                              "required": [
                                "kind",
                                "key"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "text",
                                  "description": "locale_key for one of Werk's own words, written in each reader's language; text for a name as written."
                                },
                                "text": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 60,
                                  "description": "The step's name, as written."
                                }
                              },
                              "required": [
                                "kind",
                                "text"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "The step's name: one of Werk's own words, or a name as written."
                        },
                        "bucket": {
                          "type": "string",
                          "enum": [
                            "new",
                            "in_progress",
                            "waiting",
                            "resolved",
                            "closed"
                          ],
                          "description": "The kind of step: the first step must be new, in_progress or waiting, and the last resolved or closed."
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "bucket"
                      ],
                      "additionalProperties": false
                    },
                    "description": "The steps, in order: the first must be an open step and the last one that ends the work."
                  }
                },
                "required": [
                  "clientRequestId",
                  "name",
                  "steps"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c07",
                "name": "Kitchen visit",
                "steps": [
                  {
                    "id": "open",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.open"
                    },
                    "bucket": "new"
                  },
                  {
                    "id": "measured",
                    "label": {
                      "kind": "text",
                      "text": "Measured"
                    },
                    "bucket": "in_progress"
                  },
                  {
                    "id": "done",
                    "label": {
                      "kind": "locale_key",
                      "key": "project_steps.steps.done"
                    },
                    "bucket": "resolved"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The saved template.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "template": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "simple",
                                "technicians",
                                "software",
                                "home"
                              ]
                            },
                            {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                            }
                          ],
                          "description": "The template's id, which a new project takes as templateId."
                        },
                        "builtIn": {
                          "type": "boolean",
                          "description": "True for one of Werk's own templates, false for one the key's person saved."
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60,
                          "description": "The template's name, in the reader's language for one of Werk's own."
                        },
                        "nameSource": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "locale_key",
                                  "description": "locale_key for one of Werk's own words, text for a name as written."
                                },
                                "key": {
                                  "type": "string",
                                  "enum": [
                                    "project_steps.templates.simple",
                                    "project_steps.templates.technicians",
                                    "project_steps.templates.software",
                                    "project_steps.templates.home"
                                  ],
                                  "description": "Which of Werk's own words names the template."
                                }
                              },
                              "required": [
                                "kind",
                                "key"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "text",
                                  "description": "locale_key for one of Werk's own words, text for a name as written."
                                },
                                "text": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 60,
                                  "description": "The name, as written."
                                }
                              },
                              "required": [
                                "kind",
                                "text"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "The name as stored: one of Werk's own words, or a name as written."
                        },
                        "steps": {
                          "minItems": 2,
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "maxLength": 64,
                                "pattern": "^[a-z][a-z0-9_]*$",
                                "description": "The step's id; a card's step names it as stepId."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 60,
                                "description": "The step's name, in the reader's language when it is one of Werk's own words."
                              },
                              "labelLanguage": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The language a name the project wrote is written in; absent for one of Werk's own words."
                              },
                              "labelTranslation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "A name the project wrote, in the reader's language, when it is written in another."
                              },
                              "labelSource": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "locale_key",
                                        "description": "locale_key for one of Werk's own words, text for a name as written."
                                      },
                                      "key": {
                                        "type": "string",
                                        "enum": [
                                          "project_steps.steps.open",
                                          "project_steps.steps.in_progress",
                                          "project_steps.steps.waiting_parts",
                                          "project_steps.steps.done",
                                          "project_steps.steps.paid",
                                          "project_steps.steps.in_review"
                                        ],
                                        "description": "Which of Werk's own words names the step."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "key"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "text",
                                        "description": "locale_key for one of Werk's own words, text for a name as written."
                                      },
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 60,
                                        "description": "The name, as written."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "text"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "description": "The name as stored: one of Werk's own words, or a name as written. A change of steps sends it back as label."
                              },
                              "bucket": {
                                "type": "string",
                                "enum": [
                                  "new",
                                  "in_progress",
                                  "waiting",
                                  "resolved",
                                  "closed"
                                ],
                                "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 99,
                                "description": "The step's place among the project's steps, from 0."
                              }
                            },
                            "required": [
                              "id",
                              "label",
                              "labelSource",
                              "bucket",
                              "position"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The template's steps, in order."
                        }
                      },
                      "required": [
                        "id",
                        "builtIn",
                        "name",
                        "nameSource",
                        "steps"
                      ],
                      "additionalProperties": false,
                      "description": "The saved template."
                    }
                  },
                  "required": [
                    "template"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "template": {
                    "id": "c1f5b9d3-8a2e-4c4a-96f8-1a7b9e3c5f97",
                    "builtIn": false,
                    "name": "Kitchen visit",
                    "nameSource": {
                      "kind": "text",
                      "text": "Kitchen visit"
                    },
                    "steps": [
                      {
                        "id": "open",
                        "label": "Pending",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.open"
                        },
                        "bucket": "new",
                        "position": 0
                      },
                      {
                        "id": "measured",
                        "label": "Measured",
                        "labelSource": {
                          "kind": "text",
                          "text": "Measured"
                        },
                        "bucket": "in_progress",
                        "position": 1
                      },
                      {
                        "id": "done",
                        "label": "Done",
                        "labelSource": {
                          "kind": "locale_key",
                          "key": "project_steps.steps.done"
                        },
                        "bucket": "resolved",
                        "position": 2
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "too_few_project_steps",
              "too_many_project_steps",
              "duplicate_project_step",
              "project_first_step_not_open",
              "project_last_step_not_finished",
              "invalid_project_step_label",
              "invalid_project_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/step-templates/{templateId}": {
      "delete": {
        "operationId": "DELETE /api/v1/step-templates/:templateId",
        "tags": [
          "profile"
        ],
        "summary": "Delete a step template",
        "description": "Deletes one of the key's person's saved templates, or hides one of Werk's own from their list.\n\nWerk's Simple template cannot be hidden.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "templateId",
            "in": "path",
            "required": true,
            "description": "The template's id: a saved template's, or one of Werk's own, as the template list names it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            },
            "example": "c1f5b9d3-8a2e-4c4a-96f8-1a7b9e3c5f97"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c08"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The template is gone from the key's person's list."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_request",
              "template_not_hideable"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "template_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/photo": {
      "put": {
        "operationId": "PUT /api/v1/account/photo",
        "tags": [
          "profile"
        ],
        "summary": "Change the photo",
        "description": "Sets the key's person's photo from a JPEG uploaded first with POST /assets.\n\nThe photo must fit the size a person's photo takes. Everyone in their projects sees it.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "assetId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "A photo uploaded first with POST /assets, made the key's person's photo."
                  }
                },
                "required": [
                  "clientRequestId",
                  "assetId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c04",
                "assetId": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The photo after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "photo": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "personId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person whose photo it is."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                            }
                          },
                          "required": [
                            "personId",
                            "version"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The key's person's photo after the change, or null when removed."
                    }
                  },
                  "required": [
                    "photo"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "photo": {
                    "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                    "version": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_attachment",
              "photo_side_too_large",
              "unsupported_media_type",
              "invalid_media"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "delete": {
        "operationId": "DELETE /api/v1/account/photo",
        "tags": [
          "profile"
        ],
        "summary": "Remove the photo",
        "description": "Takes the key's person's photo off.\n\nTheir initials show in its place.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c05"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The photo after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "photo": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "personId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person whose photo it is."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                            }
                          },
                          "required": [
                            "personId",
                            "version"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The key's person's photo after the change, or null when removed."
                    }
                  },
                  "required": [
                    "photo"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "photo": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_attachment"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/people/{personId}/photo": {
      "get": {
        "operationId": "GET /api/v1/people/:personId/photo",
        "tags": [
          "people"
        ],
        "summary": "Get a person's photo",
        "description": "A person's photo, as a JPEG, when the key's person shares a project with them.\n\nWith If-None-Match holding the photo's current ETag, the answer is 304 with no body.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "personId",
            "in": "path",
            "required": true,
            "description": "The person's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8"
          },
          {
            "name": "version",
            "in": "query",
            "required": false,
            "description": "The photo's version as last read; when it is no longer current, the photo is not found.",
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "The ETag of a copy already held; when it is current, the answer is 304.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The photo.",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "image/jpeg"
                }
              }
            }
          },
          "304": {
            "description": "The copy held is current."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/due-notice": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/due-notice",
        "tags": [
          "cards"
        ],
        "summary": "Change a card's due notice",
        "description": "Sets how long before its due date a card's due notice is sent.\n\nOnly the project's owner and admins may change it; a member's own alarm is a reminder. A lead equal to the card's own changes nothing.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "version": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The card's version as last read; when it changed since, the change is refused."
                  },
                  "lead": {
                    "type": "string",
                    "enum": [
                      "none",
                      "at_due",
                      "15_minutes",
                      "1_hour",
                      "2_hours",
                      "1_day",
                      "2_days"
                    ],
                    "description": "How long before the due date the notice is sent; none sends no notice."
                  }
                },
                "required": [
                  "clientRequestId",
                  "version",
                  "lead"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f08",
                "version": 7,
                "lead": "1_day"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card's lead after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "itemId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The card's id."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The card's version after the change."
                    },
                    "lead": {
                      "type": "string",
                      "enum": [
                        "none",
                        "at_due",
                        "15_minutes",
                        "1_hour",
                        "2_hours",
                        "1_day",
                        "2_days"
                      ],
                      "description": "The card's due notice lead now."
                    }
                  },
                  "required": [
                    "itemId",
                    "version",
                    "lead"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                  "version": 8,
                  "lead": "1_day"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member",
              "due_notice_owner_admin_required",
              "personal_project_restricted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards",
        "tags": [
          "cards"
        ],
        "summary": "Create a card",
        "description": "Creates a card in the project with the fields given, and files uploaded first.\n\nLeft out, the card starts on the project's first step, free, with no due date and no list. Nobody but its creator is told of a free card; a holder named is told.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "title": {
                    "type": "string",
                    "description": "The card's title."
                  },
                  "description": {
                    "type": "string",
                    "description": "The card's description."
                  },
                  "stepId": {
                    "type": "string",
                    "maxLength": 64,
                    "pattern": "^[a-z][a-z0-9_]*$",
                    "description": "The step the card starts on; left out, the project's first step."
                  },
                  "personId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The card's holder, a person of the project; left out, the card is free."
                  },
                  "due": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "date",
                            "description": "date for a due day with no time, datetime for a due moment."
                          },
                          "date": {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                            "description": "The due day, as YYYY-MM-DD."
                          }
                        },
                        "required": [
                          "kind",
                          "date"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "datetime",
                            "description": "date for a due day with no time, datetime for a due moment."
                          },
                          "at": {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                            "description": "The due moment, as an ISO 8601 date and time with Z or an offset."
                          }
                        },
                        "required": [
                          "kind",
                          "at"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "The card's due date; left out, none."
                  },
                  "entries": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "The texts of the card's list items, in order; left out, the card has no list."
                  },
                  "attachments": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "assetId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The uploaded file's id."
                            },
                            "kind": {
                              "type": "string",
                              "const": "image",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "assetId",
                            "kind"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "assetId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The uploaded file's id."
                            },
                            "kind": {
                              "type": "string",
                              "const": "document",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "assetId",
                            "kind"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Files uploaded first, with POST /assets or to an upload address, added to the card as photos or documents."
                  }
                },
                "required": [
                  "clientRequestId",
                  "title"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f01",
                "title": "Paint the hallway",
                "description": "Two coats, the same white as the kitchen.",
                "entries": [
                  "Tape the trim",
                  "Buy the paint"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The new card, as the key's person reads it.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway",
                    "language": "en-US",
                    "status": {
                      "key": "open",
                      "label": "Pending",
                      "category": "open",
                      "bucket": "new"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": null,
                    "version": 1,
                    "number": 15,
                    "currentStep": {
                      "id": "open",
                      "label": "Pending",
                      "bucket": "new"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0,
                      "checklist": {
                        "done": 0,
                        "total": 2
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "invalid_attachment",
              "invalid_media",
              "empty_text",
              "text_too_long",
              "due_past"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "photos_unavailable",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "asset_already_submitted",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards",
        "tags": [
          "cards"
        ],
        "summary": "List a project's cards",
        "description": "One page of the project's cards in a state, grouped by step in the project's order.\n\nopen holds every step but the last, done the last step, archived the archived cards. Within a step the cards keep the project's own order.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "state",
            "in": "query",
            "required": true,
            "description": "Which cards: open, done or archived.",
            "schema": {
              "type": "string",
              "enum": [
                "open",
                "done",
                "archived"
              ]
            },
            "example": "open"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many cards a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The page of cards.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "groups": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "statusKey": {
                            "type": "string",
                            "minLength": 1,
                            "description": "The step's id."
                          },
                          "label": {
                            "type": "string",
                            "minLength": 1,
                            "description": "The step's name."
                          },
                          "labelLanguage": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 64,
                            "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                          },
                          "labelTranslation": {
                            "type": "object",
                            "properties": {
                              "language": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The reader's language the text is translated into."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "ready",
                                  "pending",
                                  "failed",
                                  "paused"
                                ],
                                "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                              },
                              "text": {
                                "type": "string",
                                "description": "The translated text, present once ready."
                              }
                            },
                            "required": [
                              "language",
                              "state"
                            ],
                            "additionalProperties": false,
                            "description": "The step's name in the reader's language, when it is written in another."
                          },
                          "bucket": {
                            "type": "string",
                            "enum": [
                              "new",
                              "in_progress",
                              "waiting",
                              "resolved",
                              "closed"
                            ],
                            "description": "The kind of step as its cards' status.bucket reads it: a step that ends the work reads in_progress while it is not the project's last step."
                          },
                          "total": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many cards of this state the step holds in all."
                          },
                          "items": {
                            "minItems": 1,
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "outcome": {
                                  "type": "string",
                                  "enum": [
                                    "open",
                                    "completed",
                                    "not_completed"
                                  ],
                                  "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                                },
                                "id": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The card's id."
                                },
                                "ref": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The card's number as people write it, with # before it."
                                },
                                "title": {
                                  "type": "string",
                                  "description": "The card's title, as written."
                                },
                                "language": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "description": "The language the card's title and description are written in."
                                },
                                "titleTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The title in the reader's language, when it is written in another."
                                },
                                "status": {
                                  "type": "object",
                                  "properties": {
                                    "key": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The id of the step the card is on."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The step's name."
                                    },
                                    "category": {
                                      "type": "string",
                                      "enum": [
                                        "open",
                                        "active",
                                        "done"
                                      ],
                                      "description": "open on a new step, done on the project's last step, active on any other step."
                                    },
                                    "bucket": {
                                      "type": "string",
                                      "enum": [
                                        "new",
                                        "in_progress",
                                        "waiting",
                                        "resolved",
                                        "closed"
                                      ],
                                      "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                    },
                                    "labelLanguage": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                    },
                                    "labelTranslation": {
                                      "type": "object",
                                      "properties": {
                                        "language": {
                                          "type": "string",
                                          "minLength": 2,
                                          "maxLength": 64,
                                          "description": "The reader's language the text is translated into."
                                        },
                                        "state": {
                                          "type": "string",
                                          "enum": [
                                            "ready",
                                            "pending",
                                            "failed",
                                            "paused"
                                          ],
                                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                        },
                                        "text": {
                                          "type": "string",
                                          "description": "The translated text, present once ready."
                                        }
                                      },
                                      "required": [
                                        "language",
                                        "state"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The step's name in the reader's language, when it is written in another."
                                    }
                                  },
                                  "required": [
                                    "key",
                                    "label",
                                    "category"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step the card is on, with where that step sits in the work."
                                },
                                "dueNoticeLead": {
                                  "type": "string",
                                  "enum": [
                                    "none",
                                    "at_due",
                                    "15_minutes",
                                    "1_hour",
                                    "2_hours",
                                    "1_day",
                                    "2_days"
                                  ],
                                  "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                                },
                                "dueSetBy": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "displayName": {
                                          "type": "string",
                                          "description": "That person's name."
                                        }
                                      },
                                      "required": [
                                        "displayName"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Who set the due moment; present only for a due date with a time."
                                },
                                "due": {
                                  "anyOf": [
                                    {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "date",
                                              "description": "date for a due day with no time, datetime for a due moment."
                                            },
                                            "date": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The due day, as YYYY-MM-DD."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "date"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "datetime",
                                              "description": "date for a due day with no time, datetime for a due moment."
                                            },
                                            "at": {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                              "description": "The due moment, as an ISO 8601 date and time with its offset."
                                            },
                                            "enteredTimeZone": {
                                              "type": [
                                                "string",
                                                "null"
                                              ],
                                              "description": "The time zone the due moment was given in, when known."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "at"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The card's due date, or null when it has none."
                                },
                                "assignee": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "personId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The holder's person id."
                                        },
                                        "displayName": {
                                          "type": "string",
                                          "description": "The holder's name as the project shows it."
                                        },
                                        "initials": {
                                          "type": "string",
                                          "description": "The holder's initials, for an avatar with no photo."
                                        },
                                        "photo": {
                                          "type": "object",
                                          "properties": {
                                            "personId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person whose photo it is."
                                            },
                                            "version": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                            }
                                          },
                                          "required": [
                                            "personId",
                                            "version"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The holder's photo, when they have one."
                                        }
                                      },
                                      "required": [
                                        "displayName"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The card's holder, or null when the card is free."
                                },
                                "version": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991,
                                  "description": "The card's version, which grows with every change to it."
                                },
                                "number": {
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": 1,
                                      "maximum": 9007199254740991
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The card's number in its project, unique there and never reused."
                                },
                                "currentStep": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The step's id; a change of step sends it as stepId."
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The step's name."
                                        },
                                        "bucket": {
                                          "type": "string",
                                          "enum": [
                                            "new",
                                            "in_progress",
                                            "waiting",
                                            "resolved",
                                            "closed"
                                          ],
                                          "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                        },
                                        "labelLanguage": {
                                          "type": "string",
                                          "minLength": 2,
                                          "maxLength": 64,
                                          "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                        },
                                        "labelTranslation": {
                                          "type": "object",
                                          "properties": {
                                            "language": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The reader's language the text is translated into."
                                            },
                                            "state": {
                                              "type": "string",
                                              "enum": [
                                                "ready",
                                                "pending",
                                                "failed",
                                                "paused"
                                              ],
                                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "The translated text, present once ready."
                                            }
                                          },
                                          "required": [
                                            "language",
                                            "state"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The step's name in the reader's language, when it is written in another."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "label",
                                        "bucket"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The card's step among its project's steps, as the project defines it."
                                },
                                "archived": {
                                  "type": "boolean",
                                  "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                                },
                                "counts": {
                                  "type": "object",
                                  "properties": {
                                    "photos": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "Photos on the card."
                                    },
                                    "updates": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "Updates on the card."
                                    },
                                    "documents": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "Documents on the card."
                                    },
                                    "checklist": {
                                      "type": "object",
                                      "properties": {
                                        "done": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "List items checked."
                                        },
                                        "total": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "List items in all."
                                        }
                                      },
                                      "required": [
                                        "done",
                                        "total"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The card's list: its items checked and in all; absent when the card has no list."
                                    }
                                  },
                                  "required": [
                                    "photos",
                                    "updates",
                                    "documents"
                                  ],
                                  "additionalProperties": false,
                                  "description": "How much the card holds."
                                },
                                "allowedActions": {
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "take_card",
                                      "assign_card",
                                      "give_back_card",
                                      "move_card",
                                      "archive_card",
                                      "unarchive_card",
                                      "edit_card",
                                      "set_card_due",
                                      "add_update",
                                      "create_reminder",
                                      "link_duplicate",
                                      "add_entries",
                                      "rename_entry",
                                      "remove_entry",
                                      "reorder_entries",
                                      "follow_card",
                                      "unfollow_card",
                                      "follow_invitation",
                                      "tick_entry",
                                      "untick_entry",
                                      "set_due_notice"
                                    ]
                                  },
                                  "description": "The changes the key's person may make to this card by hand now, by action name."
                                }
                              },
                              "required": [
                                "id",
                                "ref",
                                "title",
                                "status",
                                "due",
                                "assignee",
                                "version"
                              ],
                              "additionalProperties": false
                            },
                            "description": "The step's cards on this page, in the project's own order."
                          }
                        },
                        "required": [
                          "statusKey",
                          "label",
                          "bucket",
                          "total",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The page's cards, grouped by step in the project's order."
                    },
                    "cardSizes": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "itemId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The card's id."
                          },
                          "size": {
                            "type": "string",
                            "enum": [
                              "row",
                              "normal",
                              "open"
                            ],
                            "description": "The size the key's person chose for the card: a row, its usual size, or open."
                          }
                        },
                        "required": [
                          "itemId",
                          "size"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The sizes the key's person chose for this page's cards in Werk's apps; a card left out has none saved."
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "groups",
                    "cardSizes",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "groups": [
                    {
                      "statusKey": "open",
                      "label": "Pending",
                      "bucket": "new",
                      "total": 1,
                      "items": [
                        {
                          "outcome": "open",
                          "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                          "ref": "#15",
                          "title": "Paint the hallway",
                          "language": "en-US",
                          "status": {
                            "key": "open",
                            "label": "Pending",
                            "category": "open",
                            "bucket": "new"
                          },
                          "dueNoticeLead": "at_due",
                          "due": null,
                          "assignee": null,
                          "version": 1,
                          "number": 15,
                          "currentStep": {
                            "id": "open",
                            "label": "Pending",
                            "bucket": "new"
                          },
                          "archived": false,
                          "counts": {
                            "photos": 0,
                            "updates": 0,
                            "documents": 0
                          }
                        }
                      ]
                    },
                    {
                      "statusKey": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress",
                      "total": 1,
                      "items": [
                        {
                          "outcome": "open",
                          "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                          "ref": "#14",
                          "title": "Order the quartz countertop",
                          "language": "en-US",
                          "status": {
                            "key": "in_progress",
                            "label": "In progress",
                            "category": "active",
                            "bucket": "in_progress"
                          },
                          "dueNoticeLead": "at_due",
                          "due": {
                            "kind": "datetime",
                            "at": "2026-11-25T20:00:00.000Z",
                            "enteredTimeZone": "America/New_York"
                          },
                          "dueSetBy": {
                            "displayName": "Maya Chen"
                          },
                          "assignee": {
                            "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                            "displayName": "Maya Chen",
                            "initials": "MC"
                          },
                          "version": 7,
                          "number": 14,
                          "currentStep": {
                            "id": "in_progress",
                            "label": "In progress",
                            "bucket": "in_progress"
                          },
                          "archived": false,
                          "counts": {
                            "photos": 0,
                            "updates": 0,
                            "documents": 1
                          }
                        }
                      ]
                    },
                    {
                      "statusKey": "waiting_parts",
                      "label": "Waiting for parts",
                      "bucket": "waiting",
                      "total": 1,
                      "items": [
                        {
                          "outcome": "open",
                          "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                          "ref": "#12",
                          "title": "Replace the leaking sink faucet",
                          "language": "en-US",
                          "status": {
                            "key": "waiting_parts",
                            "label": "Waiting for parts",
                            "category": "active",
                            "bucket": "waiting"
                          },
                          "dueNoticeLead": "at_due",
                          "due": null,
                          "assignee": {
                            "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                            "displayName": "Tom Okafor",
                            "initials": "TO"
                          },
                          "version": 4,
                          "number": 12,
                          "currentStep": {
                            "id": "waiting_parts",
                            "label": "Waiting for parts",
                            "bucket": "waiting"
                          },
                          "archived": false,
                          "counts": {
                            "photos": 1,
                            "updates": 1,
                            "documents": 0
                          }
                        }
                      ]
                    }
                  ],
                  "cardSizes": [],
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/step": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/step",
        "tags": [
          "cards"
        ],
        "summary": "Move a card",
        "description": "Moves a card to another step of its project.\n\nTo the last step, the card is done. A card already on that step is refused. Its holder and followers are told.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "stepId": {
                    "type": "string",
                    "maxLength": 64,
                    "pattern": "^[a-z][a-z0-9_]*$",
                    "description": "The step to move the card to, by its id in the project's steps."
                  },
                  "place": {
                    "type": "object",
                    "properties": {
                      "above": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The card shown right above the new place, or null at the top."
                      },
                      "below": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The card shown right below the new place, or null at the bottom."
                      }
                    },
                    "required": [
                      "above",
                      "below"
                    ],
                    "additionalProperties": false,
                    "description": "Where the card goes among the cards of its new step and holder; left out, Werk places it."
                  }
                },
                "required": [
                  "clientRequestId",
                  "stepId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f03",
                "stepId": "done"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the move.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "ref": "#12",
                    "title": "Replace the leaking sink faucet",
                    "language": "en-US",
                    "status": {
                      "key": "done",
                      "label": "Done",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO"
                    },
                    "version": 5,
                    "number": 12,
                    "currentStep": {
                      "id": "done",
                      "label": "Done",
                      "bucket": "resolved"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 1,
                      "updates": 1,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/holder": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/holder",
        "tags": [
          "cards"
        ],
        "summary": "Change a card's holder",
        "description": "Gives a card to a person of the project, takes it, or frees it.\n\nA card has at most one holder, who follows it and is told. Anyone may take a free card; giving one needs the right to assign.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "personId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The new holder, a person of the project; null frees the card."
                  },
                  "place": {
                    "type": "object",
                    "properties": {
                      "above": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The card shown right above the new place, or null at the top."
                      },
                      "below": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The card shown right below the new place, or null at the bottom."
                      }
                    },
                    "required": [
                      "above",
                      "below"
                    ],
                    "additionalProperties": false,
                    "description": "Where the card goes among the cards of its step and new holder; left out, Werk places it."
                  }
                },
                "required": [
                  "clientRequestId",
                  "personId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f04",
                "personId": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway",
                    "language": "en-US",
                    "status": {
                      "key": "open",
                      "label": "Pending",
                      "category": "open",
                      "bucket": "new"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                      "displayName": "Lucia Ferraro",
                      "initials": "LF"
                    },
                    "version": 2,
                    "number": 15,
                    "currentStep": {
                      "id": "open",
                      "label": "Pending",
                      "bucket": "new"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/step-and-holder": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/step-and-holder",
        "tags": [
          "cards"
        ],
        "summary": "Move and give a card",
        "description": "Moves a card to another step and changes its holder in one request, which makes one notice.\n\nBoth changes are made or neither: a card already on that step, or already held by that person, refuses the whole request.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "stepId": {
                    "type": "string",
                    "maxLength": 64,
                    "pattern": "^[a-z][a-z0-9_]*$",
                    "description": "The step to move the card to, by its id in the project's steps."
                  },
                  "place": {
                    "type": "object",
                    "properties": {
                      "above": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The card shown right above the new place, or null at the top."
                      },
                      "below": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "The card shown right below the new place, or null at the bottom."
                      }
                    },
                    "required": [
                      "above",
                      "below"
                    ],
                    "additionalProperties": false,
                    "description": "Where the card goes among the cards of its new step and holder; left out, Werk places it."
                  },
                  "personId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The new holder, a person of the project; null frees the card."
                  }
                },
                "required": [
                  "clientRequestId",
                  "stepId",
                  "personId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f05",
                "stepId": "in_progress",
                "personId": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                      "displayName": "Lucia Ferraro",
                      "initials": "LF"
                    },
                    "version": 2,
                    "number": 15,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}": {
      "patch": {
        "operationId": "PATCH /api/v1/projects/:projectId/cards/:cardId",
        "tags": [
          "cards"
        ],
        "summary": "Change a card",
        "description": "Changes several fields of a card in one request, which makes one change and one notice.\n\nEach field does what its own route does. A field whose change already held is listed in unchanged; any other refusal refuses the whole request.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "title": {
                    "type": "string",
                    "description": "The new title."
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "The new description; null removes it."
                  },
                  "stepId": {
                    "type": "string",
                    "maxLength": 64,
                    "pattern": "^[a-z][a-z0-9_]*$",
                    "description": "The step to move the card to."
                  },
                  "personId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The new holder, a person of the project; null frees the card."
                  },
                  "due": {
                    "anyOf": [
                      {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "date",
                                "description": "date for a due day with no time, datetime for a due moment."
                              },
                              "date": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                                "description": "The due day, as YYYY-MM-DD."
                              }
                            },
                            "required": [
                              "kind",
                              "date"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "datetime",
                                "description": "date for a due day with no time, datetime for a due moment."
                              },
                              "at": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                                "description": "The due moment, as an ISO 8601 date and time with Z or an offset."
                              }
                            },
                            "required": [
                              "kind",
                              "at"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The new due date; null removes it."
                  },
                  "archived": {
                    "type": "boolean",
                    "description": "True archives the card, false brings it back from the archive."
                  },
                  "note": {
                    "type": "string",
                    "description": "A note added to the card as an update."
                  },
                  "attachments": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "assetId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The uploaded file's id."
                            },
                            "kind": {
                              "type": "string",
                              "const": "image",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "assetId",
                            "kind"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "assetId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The uploaded file's id."
                            },
                            "kind": {
                              "type": "string",
                              "const": "document",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "assetId",
                            "kind"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Files uploaded first, with POST /assets or to an upload address, added in the update the note makes, or in an update of their own."
                  },
                  "dueNoticeLead": {
                    "type": "string",
                    "enum": [
                      "none",
                      "at_due",
                      "15_minutes",
                      "1_hour",
                      "2_hours",
                      "1_day",
                      "2_days"
                    ],
                    "description": "How long before the due date its due notice is sent; only the project's owner and admins may change it."
                  },
                  "entries": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "add": {
                              "type": "string",
                              "description": "The text of a new item, added at the end."
                            }
                          },
                          "required": [
                            "add"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "tick": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The id of an item to check."
                            }
                          },
                          "required": [
                            "tick"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "untick": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The id of an item to uncheck."
                            }
                          },
                          "required": [
                            "untick"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "rename": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The id of an item whose text changes to text."
                            },
                            "text": {
                              "type": "string",
                              "description": "The item's new text."
                            }
                          },
                          "required": [
                            "rename",
                            "text"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "remove": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The id of an item to take off the list."
                            }
                          },
                          "required": [
                            "remove"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "move": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The id of an item to move to place to."
                            },
                            "to": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 100,
                              "description": "The item's new place in the list, counted from 1."
                            }
                          },
                          "required": [
                            "move",
                            "to"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Changes to the card's list, each one action, applied in order."
                  },
                  "following": {
                    "type": "boolean",
                    "description": "True follows the card as the key's person, false stops following it."
                  },
                  "inviteToFollow": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "description": "People of the project invited to follow the card, by person id."
                  },
                  "duplicateOfId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The card this one duplicates; null unmarks it."
                  },
                  "removeFiles": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "photoId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "A photo's id, as the card's detail lists it."
                            }
                          },
                          "required": [
                            "photoId"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "documentId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "A document's id, as the card's detail lists it."
                            }
                          },
                          "required": [
                            "documentId"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Photos and documents to take off the card."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f02",
                "stepId": "waiting_parts",
                "note": "Stonecraft confirmed delivery for the 25th."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change, and the fields that already held.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    },
                    "unchanged": {
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string",
                            "enum": [
                              "title",
                              "description",
                              "stepId",
                              "personId",
                              "due",
                              "archived",
                              "note",
                              "dueNoticeLead",
                              "following",
                              "duplicateOfId"
                            ]
                          },
                          {
                            "type": "string",
                            "pattern": "^(entries|inviteToFollow|removeFiles)\\.-?\\d+$"
                          }
                        ]
                      },
                      "description": "The fields of the request, and items of its lists by their place from 0, that already held, so nothing changed for them."
                    }
                  },
                  "required": [
                    "item",
                    "unchanged"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "waiting_parts",
                      "label": "Waiting for parts",
                      "category": "active",
                      "bucket": "waiting"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 8,
                    "number": 14,
                    "currentStep": {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "bucket": "waiting"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 1,
                      "documents": 1
                    }
                  },
                  "unchanged": []
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "invalid_attachment",
              "invalid_media",
              "empty_text",
              "text_too_long",
              "due_past",
              "too_many_items"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "photos_unavailable",
              "not_permitted",
              "not_a_member",
              "due_notice_owner_admin_required"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "asset_already_submitted",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId",
        "tags": [
          "cards"
        ],
        "summary": "Get a card",
        "description": "A card whole: its fields, description, list, followers, reminders, documents, and its photos, updates and history, newest first.\n\nThe photos, updates and history come one page each; their cursors read older pages through the same route.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "photosLimit",
            "in": "query",
            "required": false,
            "description": "How many of the card's photos the answer holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "photosBefore",
            "in": "query",
            "required": false,
            "description": "The photos' nextCursor from an earlier answer, to read older photos.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "updatesLimit",
            "in": "query",
            "required": false,
            "description": "How many of the card's updates the answer holds.",
            "schema": {
              "default": 20,
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          },
          {
            "name": "updatesBefore",
            "in": "query",
            "required": false,
            "description": "The updates' nextCursor from an earlier answer, to read older updates.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "historyLimit",
            "in": "query",
            "required": false,
            "description": "How many history entries the answer holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "historyBefore",
            "in": "query",
            "required": false,
            "description": "The history's nextCursor from an earlier answer, to read older entries.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The card.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "followers": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "user",
                                "description": "user for a person; connector or schedule for a change Werk made without one."
                              },
                              "displayName": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The person's name as the project shows it."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "isViewer": {
                                "type": "boolean",
                                "description": "True when the person is the key's own person."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              },
                              "via": {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "enum": [
                                      "connection",
                                      "key"
                                    ],
                                    "description": "connection for an app connected by sign-in, key for an API key."
                                  },
                                  "name": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The app's or the key's name, as Werk shows it."
                                  },
                                  "verified": {
                                    "type": "boolean",
                                    "description": "True when Werk verified the app's identity."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "name",
                                  "verified",
                                  "label"
                                ],
                                "additionalProperties": false,
                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                              }
                            },
                            "required": [
                              "kind",
                              "displayName",
                              "initials",
                              "isViewer"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "connector",
                                "description": "user for a person; connector or schedule for a change Werk made without one."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The name Werk shows for a change made without a person."
                              }
                            },
                            "required": [
                              "kind",
                              "label"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "schedule",
                                "description": "user for a person; connector or schedule for a change Werk made without one."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The name Werk shows for a change made without a person."
                              }
                            },
                            "required": [
                              "kind",
                              "label"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      "description": "The people who follow the card."
                    },
                    "following": {
                      "type": "boolean",
                      "description": "True when the key's person follows the card."
                    },
                    "checklist": {
                      "type": "object",
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                        },
                        "batches": {
                          "default": [],
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The set's id, which each of its items names as batch."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "authorId": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The person who added the set, or null when no person did."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "description": "When the set was added."
                              },
                              "groupId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id of the change that added the set."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "authorId",
                              "createdAt",
                              "groupId"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The sets of items added together in one change."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The item's id."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The item's place in the list, from 0."
                              },
                              "batch": {
                                "default": null,
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The id of the set the item was added in, or null when it was added on its own."
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The item's text, as written."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The text in the reader's language, when it is written in another."
                              },
                              "checked": {
                                "type": "boolean",
                                "description": "True when the item is checked."
                              },
                              "checkedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the item was checked, or null while it is not."
                              },
                              "checkedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who checked the item, or null while it is not checked."
                              }
                            },
                            "required": [
                              "id",
                              "position",
                              "batch",
                              "text",
                              "checked",
                              "checkedAt",
                              "checkedBy"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The list's items, in their order."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "done": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items checked."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items in all."
                            }
                          },
                          "required": [
                            "done",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The list's items checked and in all."
                        }
                      },
                      "required": [
                        "batches",
                        "items",
                        "counts"
                      ],
                      "additionalProperties": false,
                      "description": "The card's list of items to check off."
                    },
                    "reminders": {
                      "type": "object",
                      "properties": {
                        "reminders": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The reminder's id."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card the reminder is on."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                              },
                              "timeRevision": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                              },
                              "snoozeRevision": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                              },
                              "fireAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The time its owner set the reminder for."
                              },
                              "effectiveFireAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                              },
                              "snoozedUntil": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The time the key's person snoozed the reminder to, or null."
                              },
                              "setterTimeZone": {
                                "type": "string",
                                "description": "The time zone the reminder's time was set in."
                              },
                              "text": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The reminder's text, as its owner wrote it."
                              },
                              "language": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The language a shared reminder's text is written in."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "A shared reminder's text in the reader's language, when it is written in another."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "upcoming",
                                  "past",
                                  "dropped"
                                ],
                                "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                              },
                              "audience": {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "enum": [
                                      "only_you",
                                      "invited_by_you",
                                      "from_owner"
                                    ],
                                    "description": "only_you for the key's person's own reminder shared with nobody, invited_by_you for their own reminder shared with others, from_owner for a reminder someone shared with them."
                                  },
                                  "label": {
                                    "type": "string",
                                    "description": "Who the reminder is for, in one line in the reader's language."
                                  },
                                  "owner": {
                                    "type": "object",
                                    "properties": {
                                      "userId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The person's id."
                                      },
                                      "displayName": {
                                        "type": "string",
                                        "description": "The person's name as the project shows it."
                                      },
                                      "initials": {
                                        "type": "string",
                                        "description": "The person's initials, for an avatar with no photo."
                                      },
                                      "isViewer": {
                                        "type": "boolean",
                                        "description": "True when the person is the key's own person."
                                      },
                                      "photo": {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person whose photo it is."
                                          },
                                          "version": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                          }
                                        },
                                        "required": [
                                          "personId",
                                          "version"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The person's photo, when they have one."
                                      }
                                    },
                                    "required": [
                                      "userId",
                                      "displayName",
                                      "initials",
                                      "isViewer"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The person who set the reminder."
                                  },
                                  "invited": {
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "userId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The person's id."
                                        },
                                        "displayName": {
                                          "type": "string",
                                          "description": "The person's name as the project shows it."
                                        },
                                        "initials": {
                                          "type": "string",
                                          "description": "The person's initials, for an avatar with no photo."
                                        },
                                        "isViewer": {
                                          "type": "boolean",
                                          "description": "True when the person is the key's own person."
                                        },
                                        "photo": {
                                          "type": "object",
                                          "properties": {
                                            "personId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person whose photo it is."
                                            },
                                            "version": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                            }
                                          },
                                          "required": [
                                            "personId",
                                            "version"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The person's photo, when they have one."
                                        }
                                      },
                                      "required": [
                                        "userId",
                                        "displayName",
                                        "initials",
                                        "isViewer"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "description": "The people the owner shared the reminder with who accepted it."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "label",
                                  "owner",
                                  "invited"
                                ],
                                "additionalProperties": false,
                                "description": "Whose reminder it is and who it is shared with."
                              },
                              "quotedReminderRef": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The reminder's id."
                                      },
                                      "expectedVersion": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The reminder's version as last read."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "expectedVersion"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The reminder's id and version as Werk's apps quote it in a chat message; null on a reminder shared by someone else."
                              },
                              "actions": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "delete",
                                    "remove",
                                    "snooze_hour",
                                    "snooze_tomorrow",
                                    "invite_in_chat"
                                  ]
                                },
                                "description": "What the key's person may do with the reminder now: delete their own, remove a shared one from their list, snooze it, share it."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "version",
                              "timeRevision",
                              "snoozeRevision",
                              "fireAt",
                              "effectiveFireAt",
                              "snoozedUntil",
                              "setterTimeZone",
                              "text",
                              "state",
                              "audience",
                              "quotedReminderRef",
                              "actions"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The next three upcoming reminders, soonest first."
                        },
                        "total": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many reminders there are in all, past and dropped ones included."
                        }
                      },
                      "required": [
                        "reminders",
                        "total"
                      ],
                      "additionalProperties": false,
                      "description": "The reminders the key's person sees on this card: the first three and how many in all."
                    },
                    "documents": {
                      "type": "object",
                      "properties": {
                        "documents": {
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The document's id."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card the document is on."
                              },
                              "filename": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255,
                                "description": "The document's name."
                              },
                              "mimeType": {
                                "type": "string",
                                "enum": [
                                  "application/pdf",
                                  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                  "text/csv",
                                  "text/plain",
                                  "text/markdown"
                                ],
                                "description": "The document's media type."
                              },
                              "revision": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The document's revision, which grows each time its file is replaced."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "not_read",
                                  "awaiting_confirmation",
                                  "reading",
                                  "failed",
                                  "ready"
                                ],
                                "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                              },
                              "totalSources": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "How many parts the document has, or null while not known."
                              },
                              "readSources": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "How many parts Werk read."
                              },
                              "truncated": {
                                "type": "boolean",
                                "description": "True when Werk read only the document's first parts."
                              },
                              "summary": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 2000
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Werk's summary of the document, or null."
                              },
                              "fields": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "issuer": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "value": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 512,
                                                "description": "The issuer as read."
                                              },
                                              "source": {
                                                "type": "object",
                                                "properties": {
                                                  "documentId": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The document's id."
                                                  },
                                                  "revision": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The revision it was read in."
                                                  },
                                                  "page": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[a-f0-9]{64}$",
                                                    "description": "The SHA-256 of the file it was read from."
                                                  },
                                                  "location": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "pdf_page",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The PDF page."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "page"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "section",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "section": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The section, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "section"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "paragraph",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "paragraph": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The paragraph, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "paragraph"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "sheet_rows",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "sheet": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The sheet's name."
                                                          },
                                                          "firstRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first row."
                                                          },
                                                          "lastRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last row."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "sheet",
                                                          "firstRow",
                                                          "lastRow"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "lines",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "firstLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first line."
                                                          },
                                                          "lastLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last line."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "firstLine",
                                                          "lastLine"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    ],
                                                    "description": "Where in the file the part is."
                                                  }
                                                },
                                                "required": [
                                                  "documentId",
                                                  "revision",
                                                  "page",
                                                  "sha256",
                                                  "location"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The part of the document it was read from."
                                              }
                                            },
                                            "required": [
                                              "value",
                                              "source"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The issuer Werk read in the document, or null when it found none."
                                      },
                                      "number": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "value": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 128,
                                                "description": "The document's number as read."
                                              },
                                              "source": {
                                                "type": "object",
                                                "properties": {
                                                  "documentId": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The document's id."
                                                  },
                                                  "revision": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The revision it was read in."
                                                  },
                                                  "page": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[a-f0-9]{64}$",
                                                    "description": "The SHA-256 of the file it was read from."
                                                  },
                                                  "location": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "pdf_page",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The PDF page."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "page"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "section",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "section": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The section, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "section"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "paragraph",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "paragraph": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The paragraph, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "paragraph"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "sheet_rows",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "sheet": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The sheet's name."
                                                          },
                                                          "firstRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first row."
                                                          },
                                                          "lastRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last row."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "sheet",
                                                          "firstRow",
                                                          "lastRow"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "lines",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "firstLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first line."
                                                          },
                                                          "lastLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last line."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "firstLine",
                                                          "lastLine"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    ],
                                                    "description": "Where in the file the part is."
                                                  }
                                                },
                                                "required": [
                                                  "documentId",
                                                  "revision",
                                                  "page",
                                                  "sha256",
                                                  "location"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The part of the document it was read from."
                                              }
                                            },
                                            "required": [
                                              "value",
                                              "source"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The document's number Werk read in the document, or null when it found none."
                                      },
                                      "date": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "value": {
                                                "type": "string",
                                                "format": "date",
                                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                "description": "The date as read, as YYYY-MM-DD."
                                              },
                                              "source": {
                                                "type": "object",
                                                "properties": {
                                                  "documentId": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The document's id."
                                                  },
                                                  "revision": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The revision it was read in."
                                                  },
                                                  "page": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[a-f0-9]{64}$",
                                                    "description": "The SHA-256 of the file it was read from."
                                                  },
                                                  "location": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "pdf_page",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The PDF page."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "page"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "section",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "section": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The section, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "section"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "paragraph",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "paragraph": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The paragraph, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "paragraph"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "sheet_rows",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "sheet": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The sheet's name."
                                                          },
                                                          "firstRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first row."
                                                          },
                                                          "lastRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last row."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "sheet",
                                                          "firstRow",
                                                          "lastRow"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "lines",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "firstLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first line."
                                                          },
                                                          "lastLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last line."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "firstLine",
                                                          "lastLine"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    ],
                                                    "description": "Where in the file the part is."
                                                  }
                                                },
                                                "required": [
                                                  "documentId",
                                                  "revision",
                                                  "page",
                                                  "sha256",
                                                  "location"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The part of the document it was read from."
                                              }
                                            },
                                            "required": [
                                              "value",
                                              "source"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The date Werk read in the document, or null when it found none."
                                      },
                                      "total": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "value": {
                                                "type": "string",
                                                "maxLength": 128,
                                                "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                                "description": "The total as read, a decimal number with a point."
                                              },
                                              "source": {
                                                "type": "object",
                                                "properties": {
                                                  "documentId": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The document's id."
                                                  },
                                                  "revision": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The revision it was read in."
                                                  },
                                                  "page": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[a-f0-9]{64}$",
                                                    "description": "The SHA-256 of the file it was read from."
                                                  },
                                                  "location": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "pdf_page",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The PDF page."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "page"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "section",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "section": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The section, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "section"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "paragraph",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "paragraph": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The paragraph, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "paragraph"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "sheet_rows",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "sheet": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The sheet's name."
                                                          },
                                                          "firstRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first row."
                                                          },
                                                          "lastRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last row."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "sheet",
                                                          "firstRow",
                                                          "lastRow"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "lines",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "firstLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first line."
                                                          },
                                                          "lastLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last line."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "firstLine",
                                                          "lastLine"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    ],
                                                    "description": "Where in the file the part is."
                                                  }
                                                },
                                                "required": [
                                                  "documentId",
                                                  "revision",
                                                  "page",
                                                  "sha256",
                                                  "location"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The part of the document it was read from."
                                              }
                                            },
                                            "required": [
                                              "value",
                                              "source"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The total Werk read in the document, or null when it found none."
                                      },
                                      "currency": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "value": {
                                                "type": "string",
                                                "pattern": "^[A-Z]{3}$",
                                                "description": "The currency as read, its ISO 4217 code."
                                              },
                                              "source": {
                                                "type": "object",
                                                "properties": {
                                                  "documentId": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The document's id."
                                                  },
                                                  "revision": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The revision it was read in."
                                                  },
                                                  "page": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                  },
                                                  "sha256": {
                                                    "type": "string",
                                                    "pattern": "^[a-f0-9]{64}$",
                                                    "description": "The SHA-256 of the file it was read from."
                                                  },
                                                  "location": {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "pdf_page",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The PDF page."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "page"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "section",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "section": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The section, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "section"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "paragraph",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "paragraph": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The paragraph, counted from 1."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "paragraph"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "sheet_rows",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "sheet": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The sheet's name."
                                                          },
                                                          "firstRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first row."
                                                          },
                                                          "lastRow": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last row."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "sheet",
                                                          "firstRow",
                                                          "lastRow"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "lines",
                                                            "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                          },
                                                          "firstLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's first line."
                                                          },
                                                          "lastLine": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part's last line."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "firstLine",
                                                          "lastLine"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    ],
                                                    "description": "Where in the file the part is."
                                                  }
                                                },
                                                "required": [
                                                  "documentId",
                                                  "revision",
                                                  "page",
                                                  "sha256",
                                                  "location"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The part of the document it was read from."
                                              }
                                            },
                                            "required": [
                                              "value",
                                              "source"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The currency Werk read in the document, or null when it found none."
                                      }
                                    },
                                    "required": [
                                      "issuer",
                                      "number",
                                      "date",
                                      "total",
                                      "currency"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                              },
                              "failureCode": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "parse_failed",
                                      "encrypted",
                                      "unsupported_format",
                                      "transcription_failed",
                                      "summary_failed",
                                      "invalid_output",
                                      "access_lost",
                                      "limit_exceeded",
                                      "provider_unavailable"
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Why reading failed, or null."
                              },
                              "units": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                              },
                              "pages": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                              },
                              "sheets": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "A workbook's sheets with data; null for other files or when not known."
                              },
                              "removable": {
                                "type": "boolean",
                                "description": "True when the key's person may take this document off the card now."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "filename",
                              "mimeType",
                              "revision",
                              "state",
                              "version",
                              "totalSources",
                              "readSources",
                              "truncated",
                              "summary",
                              "fields",
                              "failureCode",
                              "units",
                              "pages",
                              "sheets",
                              "removable"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The card's first three documents."
                        },
                        "hasMore": {
                          "type": "boolean",
                          "description": "True when the card has more documents."
                        }
                      },
                      "required": [
                        "documents",
                        "hasMore"
                      ],
                      "additionalProperties": false,
                      "description": "The documents on the card."
                    },
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card."
                    },
                    "description": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The card's description, or null when it has none."
                    },
                    "descriptionTranslation": {
                      "type": "object",
                      "properties": {
                        "language": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 64,
                          "description": "The reader's language the text is translated into."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "pending",
                            "failed",
                            "paused"
                          ],
                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                        },
                        "text": {
                          "type": "string",
                          "description": "The translated text, present once ready."
                        }
                      },
                      "required": [
                        "language",
                        "state"
                      ],
                      "additionalProperties": false,
                      "description": "The description in the reader's language, when it is written in another."
                    },
                    "author": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "user",
                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                },
                                "displayName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The person's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The person's initials, for an avatar with no photo."
                                },
                                "isViewer": {
                                  "type": "boolean",
                                  "description": "True when the person is the key's own person."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The person's photo, when they have one."
                                },
                                "via": {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "enum": [
                                        "connection",
                                        "key"
                                      ],
                                      "description": "connection for an app connected by sign-in, key for an API key."
                                    },
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The app's or the key's name, as Werk shows it."
                                    },
                                    "verified": {
                                      "type": "boolean",
                                      "description": "True when Werk verified the app's identity."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The caption Werk shows beside the change, in the reader's language."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "name",
                                    "verified",
                                    "label"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                }
                              },
                              "required": [
                                "kind",
                                "displayName",
                                "initials",
                                "isViewer"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "connector",
                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The name Werk shows for a change made without a person."
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "schedule",
                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The name Werk shows for a change made without a person."
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Who created the card, or null when no longer known."
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "description": "When the card was created."
                    },
                    "assignedBy": {
                      "anyOf": [
                        {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "user",
                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                },
                                "displayName": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The person's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The person's initials, for an avatar with no photo."
                                },
                                "isViewer": {
                                  "type": "boolean",
                                  "description": "True when the person is the key's own person."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The person's photo, when they have one."
                                },
                                "via": {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "enum": [
                                        "connection",
                                        "key"
                                      ],
                                      "description": "connection for an app connected by sign-in, key for an API key."
                                    },
                                    "name": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The app's or the key's name, as Werk shows it."
                                    },
                                    "verified": {
                                      "type": "boolean",
                                      "description": "True when Werk verified the app's identity."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The caption Werk shows beside the change, in the reader's language."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "name",
                                    "verified",
                                    "label"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                }
                              },
                              "required": [
                                "kind",
                                "displayName",
                                "initials",
                                "isViewer"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "connector",
                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The name Werk shows for a change made without a person."
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "schedule",
                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The name Werk shows for a change made without a person."
                                }
                              },
                              "required": [
                                "kind",
                                "label"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Who gave the card to its current holder, or null when that is not known."
                    },
                    "photos": {
                      "type": "object",
                      "properties": {
                        "entries": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The photo's id on the card; removing it names this id."
                              },
                              "attachedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who added the photo, or null when no longer known."
                              },
                              "asset": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The file's id."
                                  },
                                  "kind": {
                                    "type": "string",
                                    "const": "image",
                                    "description": "What the file is: a photo, a voice recording or a document."
                                  },
                                  "filename": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255,
                                    "description": "The document's name; only a document has one."
                                  },
                                  "format": {
                                    "type": "string",
                                    "enum": [
                                      "pdf",
                                      "docx",
                                      "xlsx",
                                      "csv",
                                      "txt",
                                      "md"
                                    ],
                                    "description": "The document's format; only a document has one."
                                  },
                                  "mimeType": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The file's media type."
                                  },
                                  "sizeBytes": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The file's size in bytes."
                                  },
                                  "width": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                                  },
                                  "height": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                                  },
                                  "durationSeconds": {
                                    "type": "number",
                                    "exclusiveMinimum": 0,
                                    "maximum": 300,
                                    "description": "The recording's length in seconds; only a voice recording has one."
                                  },
                                  "available": {
                                    "type": "boolean",
                                    "description": "False once the file's bytes were released and it can no longer be read."
                                  }
                                },
                                "required": [
                                  "id",
                                  "kind",
                                  "mimeType",
                                  "sizeBytes"
                                ],
                                "additionalProperties": false,
                                "description": "The photo's file."
                              },
                              "attachedAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                "description": "When the photo was added to the card."
                              },
                              "removable": {
                                "type": "boolean",
                                "description": "True when the key's person may take this photo off the card now."
                              }
                            },
                            "required": [
                              "id",
                              "attachedBy",
                              "asset",
                              "attachedAt",
                              "removable"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The photos on this page, newest first."
                        },
                        "hasMore": {
                          "type": "boolean",
                          "description": "True when older photos remain past this page."
                        },
                        "nextCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 512
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The cursor that reads the next page, or null when none remains."
                        }
                      },
                      "required": [
                        "entries",
                        "hasMore",
                        "nextCursor"
                      ],
                      "additionalProperties": false,
                      "description": "The card's photos, newest first, one page."
                    },
                    "updates": {
                      "type": "object",
                      "properties": {
                        "entries": {
                          "maxItems": 50,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The update's id."
                              },
                              "author": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who wrote the update, or null when no longer known."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                "description": "When the update was written."
                              },
                              "entries": {
                                "minItems": 1,
                                "maxItems": 50,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The entry's id."
                                    },
                                    "photos": {
                                      "type": "object",
                                      "properties": {
                                        "entries": {
                                          "maxItems": 10,
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "id": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The photo's id on the card; removing it names this id."
                                              },
                                              "attachedBy": {
                                                "anyOf": [
                                                  {
                                                    "oneOf": [
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "user",
                                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                                          },
                                                          "displayName": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The person's name as the project shows it."
                                                          },
                                                          "initials": {
                                                            "type": "string",
                                                            "description": "The person's initials, for an avatar with no photo."
                                                          },
                                                          "isViewer": {
                                                            "type": "boolean",
                                                            "description": "True when the person is the key's own person."
                                                          },
                                                          "photo": {
                                                            "type": "object",
                                                            "properties": {
                                                              "personId": {
                                                                "type": "string",
                                                                "format": "uuid",
                                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                                "description": "The person whose photo it is."
                                                              },
                                                              "version": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                              }
                                                            },
                                                            "required": [
                                                              "personId",
                                                              "version"
                                                            ],
                                                            "additionalProperties": false,
                                                            "description": "The person's photo, when they have one."
                                                          },
                                                          "via": {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "enum": [
                                                                  "connection",
                                                                  "key"
                                                                ],
                                                                "description": "connection for an app connected by sign-in, key for an API key."
                                                              },
                                                              "name": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The app's or the key's name, as Werk shows it."
                                                              },
                                                              "verified": {
                                                                "type": "boolean",
                                                                "description": "True when Werk verified the app's identity."
                                                              },
                                                              "label": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "name",
                                                              "verified",
                                                              "label"
                                                            ],
                                                            "additionalProperties": false,
                                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "displayName",
                                                          "initials",
                                                          "isViewer"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "connector",
                                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                                          },
                                                          "label": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The name Werk shows for a change made without a person."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "label"
                                                        ],
                                                        "additionalProperties": false
                                                      },
                                                      {
                                                        "type": "object",
                                                        "properties": {
                                                          "kind": {
                                                            "type": "string",
                                                            "const": "schedule",
                                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                                          },
                                                          "label": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The name Werk shows for a change made without a person."
                                                          }
                                                        },
                                                        "required": [
                                                          "kind",
                                                          "label"
                                                        ],
                                                        "additionalProperties": false
                                                      }
                                                    ]
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "Who added the photo, or null when no longer known."
                                              },
                                              "asset": {
                                                "type": "object",
                                                "properties": {
                                                  "id": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The file's id."
                                                  },
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "image",
                                                    "description": "What the file is: a photo, a voice recording or a document."
                                                  },
                                                  "filename": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "maxLength": 255,
                                                    "description": "The document's name; only a document has one."
                                                  },
                                                  "format": {
                                                    "type": "string",
                                                    "enum": [
                                                      "pdf",
                                                      "docx",
                                                      "xlsx",
                                                      "csv",
                                                      "txt",
                                                      "md"
                                                    ],
                                                    "description": "The document's format; only a document has one."
                                                  },
                                                  "mimeType": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The file's media type."
                                                  },
                                                  "sizeBytes": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The file's size in bytes."
                                                  },
                                                  "width": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                                                  },
                                                  "height": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                                                  },
                                                  "durationSeconds": {
                                                    "type": "number",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 300,
                                                    "description": "The recording's length in seconds; only a voice recording has one."
                                                  },
                                                  "available": {
                                                    "type": "boolean",
                                                    "description": "False once the file's bytes were released and it can no longer be read."
                                                  }
                                                },
                                                "required": [
                                                  "id",
                                                  "kind",
                                                  "mimeType",
                                                  "sizeBytes"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The photo's file."
                                              },
                                              "attachedAt": {
                                                "type": "string",
                                                "format": "date-time",
                                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                                "description": "When the photo was added to the card."
                                              },
                                              "removable": {
                                                "type": "boolean",
                                                "description": "True when the key's person may take this photo off the card now."
                                              }
                                            },
                                            "required": [
                                              "id",
                                              "attachedBy",
                                              "asset",
                                              "attachedAt",
                                              "removable"
                                            ],
                                            "additionalProperties": false
                                          },
                                          "description": "The photos on this page, newest first."
                                        },
                                        "hasMore": {
                                          "type": "boolean",
                                          "description": "True when older photos remain past this page."
                                        },
                                        "nextCursor": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The cursor that reads the next page, or null when none remains."
                                        }
                                      },
                                      "required": [
                                        "entries",
                                        "hasMore",
                                        "nextCursor"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The entry's photos."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The note's text, as written; empty when the entry holds photos alone."
                                    },
                                    "language": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The language the note is written in."
                                    },
                                    "translation": {
                                      "type": "object",
                                      "properties": {
                                        "language": {
                                          "type": "string",
                                          "minLength": 2,
                                          "maxLength": 64,
                                          "description": "The reader's language the text is translated into."
                                        },
                                        "state": {
                                          "type": "string",
                                          "enum": [
                                            "ready",
                                            "pending",
                                            "failed",
                                            "paused"
                                          ],
                                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                        },
                                        "text": {
                                          "type": "string",
                                          "description": "The translated text, present once ready."
                                        }
                                      },
                                      "required": [
                                        "language",
                                        "state"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The note in the reader's language, when it is written in another."
                                    },
                                    "createdAt": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                      "description": "When the entry was written."
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "photos",
                                    "text",
                                    "createdAt"
                                  ],
                                  "additionalProperties": false
                                },
                                "description": "What the update holds: its notes, each with its photos."
                              },
                              "entriesPartial": {
                                "type": "boolean",
                                "description": "True when the update holds more entries than this page shows."
                              }
                            },
                            "required": [
                              "id",
                              "author",
                              "createdAt",
                              "entries",
                              "entriesPartial"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The updates on this page, newest first."
                        },
                        "hasMore": {
                          "type": "boolean",
                          "description": "True when older updates remain past this page."
                        },
                        "nextCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 512
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The cursor that reads the next page, or null when none remains."
                        }
                      },
                      "required": [
                        "entries",
                        "hasMore",
                        "nextCursor"
                      ],
                      "additionalProperties": false,
                      "description": "The card's updates, newest first, one page."
                    },
                    "history": {
                      "type": "object",
                      "properties": {
                        "entries": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The entry's id."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                "description": "When the change was made."
                              },
                              "actor": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who made the change, or null when no longer known."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The change in one line, a step named as the project wrote it."
                              },
                              "labelTranslation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The line in the reader's language, a step named by its translation."
                              }
                            },
                            "required": [
                              "id",
                              "createdAt",
                              "actor",
                              "label"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The history's entries on this page, newest first."
                        },
                        "hasMore": {
                          "type": "boolean",
                          "description": "True when older entries remain past this page."
                        },
                        "nextCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 512
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The cursor that reads the next page as historyBefore, or null when none remains."
                        }
                      },
                      "required": [
                        "entries",
                        "hasMore",
                        "nextCursor"
                      ],
                      "additionalProperties": false,
                      "description": "The card's history, newest first, one page: every change, who made it and when."
                    },
                    "duplicates": {
                      "type": "object",
                      "properties": {
                        "of": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "itemId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "That card's id."
                                },
                                "number": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "That card's number."
                                },
                                "title": {
                                  "type": "string",
                                  "description": "That card's title."
                                },
                                "status": {
                                  "type": "string",
                                  "description": "The name of the step that card is on."
                                }
                              },
                              "required": [
                                "itemId",
                                "number",
                                "title",
                                "status"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card this one was marked a duplicate of, or null."
                        },
                        "joined": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "That card's id."
                              },
                              "number": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "That card's number."
                              },
                              "title": {
                                "type": "string",
                                "description": "That card's title."
                              },
                              "status": {
                                "type": "string",
                                "description": "The name of the step that card is on."
                              }
                            },
                            "required": [
                              "itemId",
                              "number",
                              "title",
                              "status"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The cards marked duplicates of this one."
                        }
                      },
                      "required": [
                        "of",
                        "joined"
                      ],
                      "additionalProperties": false,
                      "description": "How this card is joined to others as a duplicate."
                    }
                  },
                  "required": [
                    "followers",
                    "following",
                    "checklist",
                    "item",
                    "description",
                    "author",
                    "createdAt",
                    "assignedBy",
                    "photos",
                    "updates",
                    "history",
                    "duplicates"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "followers": [
                    {
                      "kind": "user",
                      "displayName": "Tom Okafor",
                      "initials": "TO",
                      "isViewer": false
                    },
                    {
                      "kind": "user",
                      "displayName": "Maya Chen",
                      "initials": "MC",
                      "isViewer": true
                    }
                  ],
                  "following": true,
                  "checklist": {
                    "revision": 3,
                    "batches": [
                      {
                        "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "createdAt": "2026-11-19T16:10:00.000Z",
                        "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                      }
                    ],
                    "items": [
                      {
                        "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                        "position": 0,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Shut off the water under the sink",
                        "checked": true,
                        "checkedAt": "2026-11-19T16:20:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        }
                      },
                      {
                        "id": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                        "position": 1,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Pick up the new cartridge",
                        "checked": false,
                        "checkedAt": null,
                        "checkedBy": null
                      }
                    ],
                    "counts": {
                      "done": 1,
                      "total": 2
                    }
                  },
                  "item": {
                    "outcome": "open",
                    "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "ref": "#12",
                    "title": "Replace the leaking sink faucet",
                    "language": "en-US",
                    "status": {
                      "key": "waiting_parts",
                      "label": "Waiting for parts",
                      "category": "active",
                      "bucket": "waiting"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO"
                    },
                    "version": 4,
                    "number": 12,
                    "currentStep": {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "bucket": "waiting"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 1,
                      "updates": 1,
                      "documents": 0,
                      "checklist": {
                        "done": 1,
                        "total": 2
                      }
                    }
                  },
                  "description": "The kitchen faucet drips from its base. The replacement cartridge is on order.",
                  "author": {
                    "kind": "user",
                    "displayName": "Maya Chen",
                    "initials": "MC",
                    "isViewer": true
                  },
                  "createdAt": "2026-11-18T12:30:00.000Z",
                  "assignedBy": {
                    "kind": "user",
                    "displayName": "Maya Chen",
                    "initials": "MC",
                    "isViewer": true
                  },
                  "photos": {
                    "entries": [
                      {
                        "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                        "attachedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        },
                        "asset": {
                          "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                          "kind": "image",
                          "mimeType": "image/jpeg",
                          "sizeBytes": 482113,
                          "width": 1600,
                          "height": 1200
                        },
                        "attachedAt": "2026-11-19T16:12:00.000Z",
                        "removable": true
                      }
                    ],
                    "hasMore": false,
                    "nextCursor": null
                  },
                  "updates": {
                    "entries": [
                      {
                        "id": "c9a3e7f1-4d6b-4f80-a2c8-5b1e9d3f7a46",
                        "author": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        },
                        "createdAt": "2026-11-19T16:12:00.000Z",
                        "entries": [
                          {
                            "id": "e5b9d3a7-2f8c-4b14-9e6a-7c0f2d4b8e33",
                            "photos": {
                              "entries": [
                                {
                                  "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                                  "attachedBy": {
                                    "kind": "user",
                                    "displayName": "Tom Okafor",
                                    "initials": "TO",
                                    "isViewer": false
                                  },
                                  "asset": {
                                    "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                                    "kind": "image",
                                    "mimeType": "image/jpeg",
                                    "sizeBytes": 482113,
                                    "width": 1600,
                                    "height": 1200
                                  },
                                  "attachedAt": "2026-11-19T16:12:00.000Z",
                                  "removable": true
                                }
                              ],
                              "hasMore": false,
                              "nextCursor": null
                            },
                            "text": "The base is cracked, so the whole faucet goes. Parts ordered.",
                            "language": "en-US",
                            "createdAt": "2026-11-19T16:12:00.000Z"
                          }
                        ],
                        "entriesPartial": false
                      }
                    ],
                    "hasMore": false,
                    "nextCursor": null
                  },
                  "history": {
                    "entries": [
                      {
                        "id": "f6c0e4b8-3a9d-4c25-8f1b-6d2a0e5c9f47",
                        "createdAt": "2026-11-19T16:15:00.000Z",
                        "actor": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        },
                        "label": "Tom Okafor moved it to Waiting for parts"
                      }
                    ],
                    "hasMore": false,
                    "nextCursor": null
                  },
                  "duplicates": {
                    "of": null,
                    "joined": []
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_cursor"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/archived": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/archived",
        "tags": [
          "cards"
        ],
        "summary": "Archive a card",
        "description": "Archives a card, or brings it back from the archive to the step it was on.\n\nAn archived card leaves the working lists, and its reminders no longer go off; it stays readable and searchable; there is no deleting. Archiving an archived card is refused, and so is bringing back one that is not archived.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "archived": {
                    "type": "boolean",
                    "description": "True archives the card, false brings it back from the archive."
                  }
                },
                "required": [
                  "clientRequestId",
                  "archived"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f09",
                "archived": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "not_completed",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway",
                    "language": "en-US",
                    "status": {
                      "key": "open",
                      "label": "Pending",
                      "category": "open",
                      "bucket": "new"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": null,
                    "version": 2,
                    "number": 15,
                    "currentStep": {
                      "id": "open",
                      "label": "Pending",
                      "bucket": "new"
                    },
                    "archived": true,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/text": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/text",
        "tags": [
          "cards"
        ],
        "summary": "Change a card's text",
        "description": "Changes a card's title, its description, or both.\n\nA text equal to the card's own is refused.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "title": {
                    "type": "string",
                    "description": "The new title; left out, the title stays."
                  },
                  "description": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "The new description; null removes it, and left out it stays."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f06",
                "title": "Paint the hallway and the stairs"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway and the stairs",
                    "language": "en-US",
                    "status": {
                      "key": "open",
                      "label": "Pending",
                      "category": "open",
                      "bucket": "new"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": null,
                    "version": 2,
                    "number": 15,
                    "currentStep": {
                      "id": "open",
                      "label": "Pending",
                      "bucket": "new"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "empty_text",
              "text_too_long"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/due": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/due",
        "tags": [
          "cards"
        ],
        "summary": "Change a card's due date",
        "description": "Sets a card's due date, a day or a moment, or removes it.\n\nA due date that has passed, or one equal to the card's own, is refused. The card's reminders tied to its due date move with it.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "due": {
                    "anyOf": [
                      {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "date",
                                "description": "date for a due day with no time, datetime for a due moment."
                              },
                              "date": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                                "description": "The due day, as YYYY-MM-DD."
                              }
                            },
                            "required": [
                              "kind",
                              "date"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "const": "datetime",
                                "description": "date for a due day with no time, datetime for a due moment."
                              },
                              "at": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                                "description": "The due moment, as an ISO 8601 date and time with Z or an offset."
                              }
                            },
                            "required": [
                              "kind",
                              "at"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The new due date; null removes it."
                  }
                },
                "required": [
                  "clientRequestId",
                  "due"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f07",
                "due": {
                  "kind": "date",
                  "date": "2026-11-28"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway",
                    "language": "en-US",
                    "status": {
                      "key": "open",
                      "label": "Pending",
                      "category": "open",
                      "bucket": "new"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "date",
                      "date": "2026-11-28"
                    },
                    "assignee": null,
                    "version": 2,
                    "number": 15,
                    "currentStep": {
                      "id": "open",
                      "label": "Pending",
                      "bucket": "new"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "due_past"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/updates": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/updates",
        "tags": [
          "cards"
        ],
        "summary": "Add an update",
        "description": "Adds an update to a card: a note, files uploaded first, or both.\n\nAny person of the project may add one, to an archived card too. The card's holder and followers are told.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "text": {
                    "type": "string",
                    "description": "The update's note."
                  },
                  "attachments": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "assetId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The uploaded file's id."
                            },
                            "kind": {
                              "type": "string",
                              "const": "image",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "assetId",
                            "kind"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "assetId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The uploaded file's id."
                            },
                            "kind": {
                              "type": "string",
                              "const": "document",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "assetId",
                            "kind"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "Files uploaded first, with POST /assets or to an upload address, added to the card as photos or documents."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f11",
                "text": "The new faucet arrives Monday."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the update.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "ref": "#12",
                    "title": "Replace the leaking sink faucet",
                    "language": "en-US",
                    "status": {
                      "key": "waiting_parts",
                      "label": "Waiting for parts",
                      "category": "active",
                      "bucket": "waiting"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO"
                    },
                    "version": 5,
                    "number": 12,
                    "currentStep": {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "bucket": "waiting"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 1,
                      "updates": 2,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "invalid_attachment",
              "invalid_media",
              "empty_text",
              "text_too_long"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "photos_unavailable",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "asset_already_submitted",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/photos/{photoId}": {
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/cards/:cardId/photos/:photoId",
        "tags": [
          "files"
        ],
        "summary": "Remove a card's photo",
        "description": "Takes a photo off a card.\n\nWho may take it off depends on who added it. The removal is a change in the card's history. A photo already off is refused.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "photoId",
            "in": "path",
            "required": true,
            "description": "The photo's id on the card.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4e01"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "ref": "#12",
                    "title": "Replace the leaking sink faucet",
                    "language": "en-US",
                    "status": {
                      "key": "waiting_parts",
                      "label": "Waiting for parts",
                      "category": "active",
                      "bucket": "waiting"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO"
                    },
                    "version": 5,
                    "number": 12,
                    "currentStep": {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "bucket": "waiting"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 1,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_permitted",
              "actor_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/documents/{documentId}": {
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/cards/:cardId/documents/:documentId",
        "tags": [
          "files"
        ],
        "summary": "Remove a card's document",
        "description": "Takes a document off a card.\n\nWho may take it off depends on who added it. The removal is a change in the card's history.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "The document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4e02"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 8,
                    "number": 14,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_permitted",
              "actor_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/documents/:documentId",
        "tags": [
          "files"
        ],
        "summary": "Get a document",
        "description": "One document on a card: its state, Werk's summary and the values it read in it.\n\nOnly a document whose card is the one named is found.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "The document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          }
        ],
        "responses": {
          "200": {
            "description": "The document.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "document": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The document's id."
                        },
                        "itemId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card the document is on."
                        },
                        "filename": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 255,
                          "description": "The document's name."
                        },
                        "mimeType": {
                          "type": "string",
                          "enum": [
                            "application/pdf",
                            "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                            "text/csv",
                            "text/plain",
                            "text/markdown"
                          ],
                          "description": "The document's media type."
                        },
                        "revision": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The document's revision, which grows each time its file is replaced."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "not_read",
                            "awaiting_confirmation",
                            "reading",
                            "failed",
                            "ready"
                          ],
                          "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                        },
                        "totalSources": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "How many parts the document has, or null while not known."
                        },
                        "readSources": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many parts Werk read."
                        },
                        "truncated": {
                          "type": "boolean",
                          "description": "True when Werk read only the document's first parts."
                        },
                        "summary": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 2000
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Werk's summary of the document, or null."
                        },
                        "fields": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "issuer": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "value": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 512,
                                          "description": "The issuer as read."
                                        },
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "documentId": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The document's id."
                                            },
                                            "revision": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The revision it was read in."
                                            },
                                            "page": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                            },
                                            "sha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$",
                                              "description": "The SHA-256 of the file it was read from."
                                            },
                                            "location": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "pdf_page",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The PDF page."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "page"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "section",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "section": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The section, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "section"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "paragraph",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "paragraph": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The paragraph, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "paragraph"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "sheet_rows",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "sheet": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The sheet's name."
                                                    },
                                                    "firstRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first row."
                                                    },
                                                    "lastRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last row."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "sheet",
                                                    "firstRow",
                                                    "lastRow"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "lines",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "firstLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first line."
                                                    },
                                                    "lastLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last line."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "firstLine",
                                                    "lastLine"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ],
                                              "description": "Where in the file the part is."
                                            }
                                          },
                                          "required": [
                                            "documentId",
                                            "revision",
                                            "page",
                                            "sha256",
                                            "location"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The part of the document it was read from."
                                        }
                                      },
                                      "required": [
                                        "value",
                                        "source"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The issuer Werk read in the document, or null when it found none."
                                },
                                "number": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "value": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128,
                                          "description": "The document's number as read."
                                        },
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "documentId": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The document's id."
                                            },
                                            "revision": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The revision it was read in."
                                            },
                                            "page": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                            },
                                            "sha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$",
                                              "description": "The SHA-256 of the file it was read from."
                                            },
                                            "location": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "pdf_page",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The PDF page."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "page"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "section",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "section": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The section, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "section"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "paragraph",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "paragraph": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The paragraph, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "paragraph"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "sheet_rows",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "sheet": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The sheet's name."
                                                    },
                                                    "firstRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first row."
                                                    },
                                                    "lastRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last row."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "sheet",
                                                    "firstRow",
                                                    "lastRow"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "lines",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "firstLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first line."
                                                    },
                                                    "lastLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last line."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "firstLine",
                                                    "lastLine"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ],
                                              "description": "Where in the file the part is."
                                            }
                                          },
                                          "required": [
                                            "documentId",
                                            "revision",
                                            "page",
                                            "sha256",
                                            "location"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The part of the document it was read from."
                                        }
                                      },
                                      "required": [
                                        "value",
                                        "source"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The document's number Werk read in the document, or null when it found none."
                                },
                                "date": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "value": {
                                          "type": "string",
                                          "format": "date",
                                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                          "description": "The date as read, as YYYY-MM-DD."
                                        },
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "documentId": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The document's id."
                                            },
                                            "revision": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The revision it was read in."
                                            },
                                            "page": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                            },
                                            "sha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$",
                                              "description": "The SHA-256 of the file it was read from."
                                            },
                                            "location": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "pdf_page",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The PDF page."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "page"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "section",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "section": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The section, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "section"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "paragraph",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "paragraph": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The paragraph, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "paragraph"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "sheet_rows",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "sheet": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The sheet's name."
                                                    },
                                                    "firstRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first row."
                                                    },
                                                    "lastRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last row."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "sheet",
                                                    "firstRow",
                                                    "lastRow"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "lines",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "firstLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first line."
                                                    },
                                                    "lastLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last line."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "firstLine",
                                                    "lastLine"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ],
                                              "description": "Where in the file the part is."
                                            }
                                          },
                                          "required": [
                                            "documentId",
                                            "revision",
                                            "page",
                                            "sha256",
                                            "location"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The part of the document it was read from."
                                        }
                                      },
                                      "required": [
                                        "value",
                                        "source"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The date Werk read in the document, or null when it found none."
                                },
                                "total": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "value": {
                                          "type": "string",
                                          "maxLength": 128,
                                          "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                          "description": "The total as read, a decimal number with a point."
                                        },
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "documentId": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The document's id."
                                            },
                                            "revision": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The revision it was read in."
                                            },
                                            "page": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                            },
                                            "sha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$",
                                              "description": "The SHA-256 of the file it was read from."
                                            },
                                            "location": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "pdf_page",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The PDF page."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "page"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "section",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "section": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The section, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "section"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "paragraph",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "paragraph": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The paragraph, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "paragraph"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "sheet_rows",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "sheet": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The sheet's name."
                                                    },
                                                    "firstRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first row."
                                                    },
                                                    "lastRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last row."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "sheet",
                                                    "firstRow",
                                                    "lastRow"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "lines",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "firstLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first line."
                                                    },
                                                    "lastLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last line."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "firstLine",
                                                    "lastLine"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ],
                                              "description": "Where in the file the part is."
                                            }
                                          },
                                          "required": [
                                            "documentId",
                                            "revision",
                                            "page",
                                            "sha256",
                                            "location"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The part of the document it was read from."
                                        }
                                      },
                                      "required": [
                                        "value",
                                        "source"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The total Werk read in the document, or null when it found none."
                                },
                                "currency": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "value": {
                                          "type": "string",
                                          "pattern": "^[A-Z]{3}$",
                                          "description": "The currency as read, its ISO 4217 code."
                                        },
                                        "source": {
                                          "type": "object",
                                          "properties": {
                                            "documentId": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The document's id."
                                            },
                                            "revision": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The revision it was read in."
                                            },
                                            "page": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                            },
                                            "sha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$",
                                              "description": "The SHA-256 of the file it was read from."
                                            },
                                            "location": {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "pdf_page",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The PDF page."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "page"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "section",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "section": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The section, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "section"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "paragraph",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "paragraph": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The paragraph, counted from 1."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "paragraph"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "sheet_rows",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "sheet": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The sheet's name."
                                                    },
                                                    "firstRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first row."
                                                    },
                                                    "lastRow": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last row."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "sheet",
                                                    "firstRow",
                                                    "lastRow"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "lines",
                                                      "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                    },
                                                    "firstLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's first line."
                                                    },
                                                    "lastLine": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part's last line."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "firstLine",
                                                    "lastLine"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ],
                                              "description": "Where in the file the part is."
                                            }
                                          },
                                          "required": [
                                            "documentId",
                                            "revision",
                                            "page",
                                            "sha256",
                                            "location"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The part of the document it was read from."
                                        }
                                      },
                                      "required": [
                                        "value",
                                        "source"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The currency Werk read in the document, or null when it found none."
                                }
                              },
                              "required": [
                                "issuer",
                                "number",
                                "date",
                                "total",
                                "currency"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                        },
                        "failureCode": {
                          "anyOf": [
                            {
                              "type": "string",
                              "enum": [
                                "parse_failed",
                                "encrypted",
                                "unsupported_format",
                                "transcription_failed",
                                "summary_failed",
                                "invalid_output",
                                "access_lost",
                                "limit_exceeded",
                                "provider_unavailable"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Why reading failed, or null."
                        },
                        "units": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                        },
                        "pages": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                        },
                        "sheets": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "A workbook's sheets with data; null for other files or when not known."
                        },
                        "removable": {
                          "type": "boolean",
                          "description": "True when the key's person may take this document off the card now."
                        }
                      },
                      "required": [
                        "id",
                        "itemId",
                        "filename",
                        "mimeType",
                        "revision",
                        "state",
                        "version",
                        "totalSources",
                        "readSources",
                        "truncated",
                        "summary",
                        "fields",
                        "failureCode",
                        "units",
                        "pages",
                        "sheets",
                        "removable"
                      ],
                      "additionalProperties": false,
                      "description": "The document."
                    }
                  },
                  "required": [
                    "document"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "document": {
                    "id": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                    "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "filename": "countertop-quote.pdf",
                    "mimeType": "application/pdf",
                    "revision": 1,
                    "state": "ready",
                    "version": 3,
                    "totalSources": 2,
                    "readSources": 2,
                    "truncated": false,
                    "summary": "Stonecraft Supply's quote for a quartz countertop, cut and installed, with delivery in two weeks.",
                    "fields": {
                      "issuer": {
                        "value": "Stonecraft Supply",
                        "source": {
                          "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                          "revision": 1,
                          "page": 1,
                          "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                          "location": {
                            "kind": "pdf_page",
                            "page": 1
                          }
                        }
                      },
                      "number": {
                        "value": "Q-20931",
                        "source": {
                          "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                          "revision": 1,
                          "page": 1,
                          "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                          "location": {
                            "kind": "pdf_page",
                            "page": 1
                          }
                        }
                      },
                      "date": {
                        "value": "2026-11-17",
                        "source": {
                          "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                          "revision": 1,
                          "page": 1,
                          "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                          "location": {
                            "kind": "pdf_page",
                            "page": 1
                          }
                        }
                      },
                      "total": {
                        "value": "2480.00",
                        "source": {
                          "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                          "revision": 1,
                          "page": 2,
                          "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                          "location": {
                            "kind": "pdf_page",
                            "page": 2
                          }
                        }
                      },
                      "currency": {
                        "value": "USD",
                        "source": {
                          "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                          "revision": 1,
                          "page": 2,
                          "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                          "location": {
                            "kind": "pdf_page",
                            "page": 2
                          }
                        }
                      }
                    },
                    "failureCode": null,
                    "units": 1,
                    "pages": 2,
                    "sheets": null,
                    "removable": true
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/reminders": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/reminders",
        "tags": [
          "reminders"
        ],
        "summary": "Set a card reminder",
        "description": "Sets a reminder for the key's person on a card, private to them.\n\nIt goes off at a set time, or a span before the card's due date. A time that is not in the future, the same reminder set twice, or a span before the due date on a card with none is refused; a person keeps at most five reminders of their own on one card.",
        "x-werk-group": "create",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "when": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "at",
                            "description": "at for a set time, before_due for a span before the card's due date."
                          },
                          "at": {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                            "description": "The time, as a day YYYY-MM-DD or an ISO 8601 date and time with Z or an offset."
                          }
                        },
                        "required": [
                          "kind",
                          "at"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "before_due",
                            "description": "at for a set time, before_due for a span before the card's due date."
                          },
                          "amount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 10000,
                            "description": "How many minutes, hours or days before the due date."
                          },
                          "unit": {
                            "type": "string",
                            "enum": [
                              "minutes",
                              "hours",
                              "days"
                            ],
                            "description": "The unit of amount."
                          },
                          "time": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "For a span in days, the time of day it goes off, as HH:MM; null takes the due date's time, or the daily brief's time for a due day with none."
                          }
                        },
                        "required": [
                          "kind",
                          "amount",
                          "unit",
                          "time"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "When the reminder goes off: at a time, or a span before the card's due date."
                  },
                  "text": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "What the reminder is for, in its owner's words; null for none."
                  }
                },
                "required": [
                  "clientRequestId",
                  "when",
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a04",
                "when": {
                  "kind": "at",
                  "at": "2026-11-24T08:00:00-05:00"
                },
                "text": "Call the supplier about delivery"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card the reminder is on, as the key's person reads it after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 7,
                    "number": 14,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "empty_text",
              "personal_reminder_text_too_long",
              "personal_reminder_limit",
              "personal_reminder_invalid_time"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale",
              "personal_reminder_source_expired",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/reminders",
        "tags": [
          "reminders"
        ],
        "summary": "List a card's reminders",
        "description": "The reminders on a card that the key's person sees: their own, and those others shared with them that they accepted.\n\nA reminder is private to its owner until shared; nobody else sees it.",
        "x-werk-group": "read",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The card's reminders.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "reminders": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The reminder's id."
                          },
                          "itemId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The card the reminder is on."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                          },
                          "timeRevision": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                          },
                          "snoozeRevision": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                          },
                          "fireAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The time its owner set the reminder for."
                          },
                          "effectiveFireAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                          },
                          "snoozedUntil": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The time the key's person snoozed the reminder to, or null."
                          },
                          "setterTimeZone": {
                            "type": "string",
                            "description": "The time zone the reminder's time was set in."
                          },
                          "text": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The reminder's text, as its owner wrote it."
                          },
                          "language": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 64,
                            "description": "The language a shared reminder's text is written in."
                          },
                          "translation": {
                            "type": "object",
                            "properties": {
                              "language": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The reader's language the text is translated into."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "ready",
                                  "pending",
                                  "failed",
                                  "paused"
                                ],
                                "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                              },
                              "text": {
                                "type": "string",
                                "description": "The translated text, present once ready."
                              }
                            },
                            "required": [
                              "language",
                              "state"
                            ],
                            "additionalProperties": false,
                            "description": "A shared reminder's text in the reader's language, when it is written in another."
                          },
                          "state": {
                            "type": "string",
                            "enum": [
                              "upcoming",
                              "past",
                              "dropped"
                            ],
                            "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                          },
                          "audience": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "only_you",
                                  "invited_by_you",
                                  "from_owner"
                                ],
                                "description": "only_you for the key's person's own reminder shared with nobody, invited_by_you for their own reminder shared with others, from_owner for a reminder someone shared with them."
                              },
                              "label": {
                                "type": "string",
                                "description": "Who the reminder is for, in one line in the reader's language."
                              },
                              "owner": {
                                "type": "object",
                                "properties": {
                                  "userId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person's id."
                                  },
                                  "displayName": {
                                    "type": "string",
                                    "description": "The person's name as the project shows it."
                                  },
                                  "initials": {
                                    "type": "string",
                                    "description": "The person's initials, for an avatar with no photo."
                                  },
                                  "isViewer": {
                                    "type": "boolean",
                                    "description": "True when the person is the key's own person."
                                  },
                                  "photo": {
                                    "type": "object",
                                    "properties": {
                                      "personId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The person whose photo it is."
                                      },
                                      "version": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                      }
                                    },
                                    "required": [
                                      "personId",
                                      "version"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The person's photo, when they have one."
                                  }
                                },
                                "required": [
                                  "userId",
                                  "displayName",
                                  "initials",
                                  "isViewer"
                                ],
                                "additionalProperties": false,
                                "description": "The person who set the reminder."
                              },
                              "invited": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "userId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person's id."
                                    },
                                    "displayName": {
                                      "type": "string",
                                      "description": "The person's name as the project shows it."
                                    },
                                    "initials": {
                                      "type": "string",
                                      "description": "The person's initials, for an avatar with no photo."
                                    },
                                    "isViewer": {
                                      "type": "boolean",
                                      "description": "True when the person is the key's own person."
                                    },
                                    "photo": {
                                      "type": "object",
                                      "properties": {
                                        "personId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The person whose photo it is."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                        }
                                      },
                                      "required": [
                                        "personId",
                                        "version"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The person's photo, when they have one."
                                    }
                                  },
                                  "required": [
                                    "userId",
                                    "displayName",
                                    "initials",
                                    "isViewer"
                                  ],
                                  "additionalProperties": false
                                },
                                "description": "The people the owner shared the reminder with who accepted it."
                              }
                            },
                            "required": [
                              "kind",
                              "label",
                              "owner",
                              "invited"
                            ],
                            "additionalProperties": false,
                            "description": "Whose reminder it is and who it is shared with."
                          },
                          "quotedReminderRef": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The reminder's id."
                                  },
                                  "expectedVersion": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The reminder's version as last read."
                                  }
                                },
                                "required": [
                                  "id",
                                  "expectedVersion"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The reminder's id and version as Werk's apps quote it in a chat message; null on a reminder shared by someone else."
                          },
                          "actions": {
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "delete",
                                "remove",
                                "snooze_hour",
                                "snooze_tomorrow",
                                "invite_in_chat"
                              ]
                            },
                            "description": "What the key's person may do with the reminder now: delete their own, remove a shared one from their list, snooze it, share it."
                          }
                        },
                        "required": [
                          "id",
                          "itemId",
                          "version",
                          "timeRevision",
                          "snoozeRevision",
                          "fireAt",
                          "effectiveFireAt",
                          "snoozedUntil",
                          "setterTimeZone",
                          "text",
                          "state",
                          "audience",
                          "quotedReminderRef",
                          "actions"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The reminders."
                    },
                    "total": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many reminders there are in all."
                    }
                  },
                  "required": [
                    "reminders",
                    "total"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "reminders": [
                    {
                      "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                      "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                      "version": 1,
                      "timeRevision": 1,
                      "snoozeRevision": 0,
                      "fireAt": "2026-11-24T13:00:00.000Z",
                      "effectiveFireAt": "2026-11-24T13:00:00.000Z",
                      "snoozedUntil": null,
                      "setterTimeZone": "America/New_York",
                      "text": "Call the supplier about delivery",
                      "state": "upcoming",
                      "audience": {
                        "kind": "only_you",
                        "label": "Only you",
                        "owner": {
                          "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                          "displayName": "Maya Chen",
                          "initials": "MC",
                          "isViewer": true
                        },
                        "invited": []
                      },
                      "quotedReminderRef": {
                        "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                        "expectedVersion": 1
                      },
                      "actions": [
                        "delete",
                        "snooze_hour",
                        "snooze_tomorrow",
                        "invite_in_chat"
                      ]
                    }
                  ],
                  "total": 1
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/reminders/{reminderId}": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/reminders/:reminderId",
        "tags": [
          "reminders"
        ],
        "summary": "Change a card's reminder",
        "description": "Changes the time or the text of one of the key's person's own reminders on a card.\n\nWhat is left out stays. The change is refused when the reminder changed or was snoozed since it was read; a reminder someone shared is not theirs to change.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the change is refused."
                  },
                  "expectedTimeRevision": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The reminder's timeRevision as last read; when its time changed since, the change is refused."
                  },
                  "expectedSnoozeRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's snoozeRevision as last read; when it was snoozed since, the change is refused."
                  },
                  "when": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "at",
                            "description": "at for a set time, before_due for a span before the card's due date."
                          },
                          "at": {
                            "type": "string",
                            "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                            "description": "The time, as a day YYYY-MM-DD or an ISO 8601 date and time with Z or an offset."
                          }
                        },
                        "required": [
                          "kind",
                          "at"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "before_due",
                            "description": "at for a set time, before_due for a span before the card's due date."
                          },
                          "amount": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 10000,
                            "description": "How many minutes, hours or days before the due date."
                          },
                          "unit": {
                            "type": "string",
                            "enum": [
                              "minutes",
                              "hours",
                              "days"
                            ],
                            "description": "The unit of amount."
                          },
                          "time": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "For a span in days, the time of day it goes off, as HH:MM; null takes the due date's time, or the daily brief's time for a due day with none."
                          }
                        },
                        "required": [
                          "kind",
                          "amount",
                          "unit",
                          "time"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "The new time; left out, it stays."
                  },
                  "text": {
                    "type": "string",
                    "description": "The new text; left out, it stays."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "expectedTimeRevision",
                  "expectedSnoozeRevision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a05",
                "expectedVersion": 1,
                "expectedTimeRevision": 1,
                "expectedSnoozeRevision": 0,
                "when": {
                  "kind": "before_due",
                  "amount": 1,
                  "unit": "days",
                  "time": "09:00"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card the reminder is on, as the key's person reads it after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 7,
                    "number": 14,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "empty_text",
              "personal_reminder_text_too_long",
              "personal_reminder_invalid_time"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "personal_reminder_not_owner"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale",
              "personal_reminder_source_expired",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/reminders/:reminderId",
        "tags": [
          "reminders"
        ],
        "summary": "Get a card's reminder",
        "description": "One reminder on a card, with the card.\n\nOnly a reminder of that card that the key's person sees is found.",
        "x-werk-group": "read",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The reminder and its card.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "reminder": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The reminder's id."
                        },
                        "itemId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card the reminder is on."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                        },
                        "timeRevision": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                        },
                        "snoozeRevision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                        },
                        "fireAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The time its owner set the reminder for."
                        },
                        "effectiveFireAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                        },
                        "snoozedUntil": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The time the key's person snoozed the reminder to, or null."
                        },
                        "setterTimeZone": {
                          "type": "string",
                          "description": "The time zone the reminder's time was set in."
                        },
                        "text": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The reminder's text, as its owner wrote it."
                        },
                        "language": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 64,
                          "description": "The language a shared reminder's text is written in."
                        },
                        "translation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "A shared reminder's text in the reader's language, when it is written in another."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "upcoming",
                            "past",
                            "dropped"
                          ],
                          "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                        },
                        "audience": {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "enum": [
                                "only_you",
                                "invited_by_you",
                                "from_owner"
                              ],
                              "description": "only_you for the key's person's own reminder shared with nobody, invited_by_you for their own reminder shared with others, from_owner for a reminder someone shared with them."
                            },
                            "label": {
                              "type": "string",
                              "description": "Who the reminder is for, in one line in the reader's language."
                            },
                            "owner": {
                              "type": "object",
                              "properties": {
                                "userId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person's id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The person's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The person's initials, for an avatar with no photo."
                                },
                                "isViewer": {
                                  "type": "boolean",
                                  "description": "True when the person is the key's own person."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The person's photo, when they have one."
                                }
                              },
                              "required": [
                                "userId",
                                "displayName",
                                "initials",
                                "isViewer"
                              ],
                              "additionalProperties": false,
                              "description": "The person who set the reminder."
                            },
                            "invited": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "userId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person's id."
                                  },
                                  "displayName": {
                                    "type": "string",
                                    "description": "The person's name as the project shows it."
                                  },
                                  "initials": {
                                    "type": "string",
                                    "description": "The person's initials, for an avatar with no photo."
                                  },
                                  "isViewer": {
                                    "type": "boolean",
                                    "description": "True when the person is the key's own person."
                                  },
                                  "photo": {
                                    "type": "object",
                                    "properties": {
                                      "personId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The person whose photo it is."
                                      },
                                      "version": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                      }
                                    },
                                    "required": [
                                      "personId",
                                      "version"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The person's photo, when they have one."
                                  }
                                },
                                "required": [
                                  "userId",
                                  "displayName",
                                  "initials",
                                  "isViewer"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The people the owner shared the reminder with who accepted it."
                            }
                          },
                          "required": [
                            "kind",
                            "label",
                            "owner",
                            "invited"
                          ],
                          "additionalProperties": false,
                          "description": "Whose reminder it is and who it is shared with."
                        },
                        "quotedReminderRef": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The reminder's id."
                                },
                                "expectedVersion": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The reminder's version as last read."
                                }
                              },
                              "required": [
                                "id",
                                "expectedVersion"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The reminder's id and version as Werk's apps quote it in a chat message; null on a reminder shared by someone else."
                        },
                        "actions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "delete",
                              "remove",
                              "snooze_hour",
                              "snooze_tomorrow",
                              "invite_in_chat"
                            ]
                          },
                          "description": "What the key's person may do with the reminder now: delete their own, remove a shared one from their list, snooze it, share it."
                        }
                      },
                      "required": [
                        "id",
                        "itemId",
                        "version",
                        "timeRevision",
                        "snoozeRevision",
                        "fireAt",
                        "effectiveFireAt",
                        "snoozedUntil",
                        "setterTimeZone",
                        "text",
                        "state",
                        "audience",
                        "quotedReminderRef",
                        "actions"
                      ],
                      "additionalProperties": false,
                      "description": "The reminder."
                    },
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card the reminder is on."
                    }
                  },
                  "required": [
                    "reminder",
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "reminder": {
                    "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                    "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "version": 1,
                    "timeRevision": 1,
                    "snoozeRevision": 0,
                    "fireAt": "2026-11-24T13:00:00.000Z",
                    "effectiveFireAt": "2026-11-24T13:00:00.000Z",
                    "snoozedUntil": null,
                    "setterTimeZone": "America/New_York",
                    "text": "Call the supplier about delivery",
                    "state": "upcoming",
                    "audience": {
                      "kind": "only_you",
                      "label": "Only you",
                      "owner": {
                        "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "displayName": "Maya Chen",
                        "initials": "MC",
                        "isViewer": true
                      },
                      "invited": []
                    },
                    "quotedReminderRef": {
                      "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                      "expectedVersion": 1
                    },
                    "actions": [
                      "delete",
                      "snooze_hour",
                      "snooze_tomorrow",
                      "invite_in_chat"
                    ]
                  },
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 7,
                    "number": 14,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/cards/:cardId/reminders/:reminderId",
        "tags": [
          "reminders"
        ],
        "summary": "Delete a card's reminder",
        "description": "Deletes one of the key's person's own reminders on a card.\n\nRefused when the reminder changed or was snoozed since it was read. A reminder someone shared is taken off the key's person's list with its remove route instead.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the change is refused."
                  },
                  "expectedTimeRevision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's timeRevision as last read; when its time changed since, the change is refused."
                  },
                  "expectedSnoozeRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's snoozeRevision as last read; when it was snoozed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "expectedTimeRevision",
                  "expectedSnoozeRevision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a07",
                "expectedVersion": 1,
                "expectedTimeRevision": 1,
                "expectedSnoozeRevision": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the request did.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "applied",
                        "unchanged"
                      ],
                      "description": "applied when the change was made, unchanged when it already held."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id of the thing changed."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Its version after the request."
                    }
                  },
                  "required": [
                    "kind",
                    "id",
                    "version"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "kind": "applied",
                  "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                  "version": 2
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_reminder_not_owner"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/reminders/{reminderId}/share": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/reminders/:reminderId/share",
        "tags": [
          "reminders"
        ],
        "summary": "Share a card's reminder",
        "description": "Invites a person of the project to take one of the key's person's reminders on a card.\n\nThe person is told at once and the reminder becomes theirs too only when they accept; they must see the card. A second invitation while one waits sends nothing new, and a reminder whose card is done or archived, or whose time has passed, is refused.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the share is refused."
                  },
                  "personId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The person of the project the reminder is shared with, who must see the card."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "personId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a06",
                "expectedVersion": 2,
                "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card the reminder is on, as the key's person reads it after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 7,
                    "number": 14,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "personal_reminder_not_owner",
              "personal_project_restricted",
              "personal_reminder_recipient_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale",
              "personal_reminder_source_expired",
              "personal_reminder_invitation_expired",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/follow-invitations": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/follow-invitations",
        "tags": [
          "cards"
        ],
        "summary": "Invite to follow a card",
        "description": "Invites a person of the project who sees the card to follow it.\n\nThe person is told at once and follows only when they accept. One invitation per person per card waits at a time; a person who already follows gets none.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "personId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The person of the project invited to follow the card, who must see it."
                  }
                },
                "required": [
                  "clientRequestId",
                  "personId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f14",
                "personId": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "ref": "#14",
                    "title": "Order the quartz countertop",
                    "language": "en-US",
                    "status": {
                      "key": "in_progress",
                      "label": "In progress",
                      "category": "active",
                      "bucket": "in_progress"
                    },
                    "dueNoticeLead": "at_due",
                    "due": {
                      "kind": "datetime",
                      "at": "2026-11-25T20:00:00.000Z",
                      "enteredTimeZone": "America/New_York"
                    },
                    "dueSetBy": {
                      "displayName": "Maya Chen"
                    },
                    "assignee": {
                      "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC"
                    },
                    "version": 7,
                    "number": 14,
                    "currentStep": {
                      "id": "in_progress",
                      "label": "In progress",
                      "bucket": "in_progress"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query",
              "follow_invitation_unavailable"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "personal_project_restricted",
              "follow_invitation_actor_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "follow_invitation_stale",
              "follow_invitation_source_expired",
              "item_version_conflict",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/duplicate-of": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/duplicate-of",
        "tags": [
          "cards"
        ],
        "summary": "Mark a duplicate card",
        "description": "Marks a card as a duplicate of another card of the same project.\n\nA card cannot duplicate itself, a done card or a card that is itself a duplicate. The mark is removed with the card's change route.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "duplicateOfId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The card this one duplicates, in the same project."
                  }
                },
                "required": [
                  "clientRequestId",
                  "duplicateOfId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f10",
                "duplicateOfId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The card after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "6e2a8d43-1c7b-4f95-a3d6-0b4e9c1f7a25",
                    "ref": "#15",
                    "title": "Paint the hallway",
                    "language": "en-US",
                    "status": {
                      "key": "open",
                      "label": "Pending",
                      "category": "open",
                      "bucket": "new"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": null,
                    "version": 2,
                    "number": 15,
                    "currentStep": {
                      "id": "open",
                      "label": "Pending",
                      "bucket": "new"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 0,
                      "updates": 0,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted",
              "not_a_member"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "card_archived",
              "project_profile_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/timezone": {
      "put": {
        "operationId": "PUT /api/v1/account/timezone",
        "tags": [
          "profile"
        ],
        "summary": "Change the time zone",
        "description": "Sets the key's person's time zone, which their days, due dates and brief are read in.\n\nA zone Werk does not know is refused.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "timeZone": {
                    "type": "string",
                    "maxLength": 128,
                    "description": "The key's person's time zone, as an IANA time zone name."
                  }
                },
                "required": [
                  "clientRequestId",
                  "timeZone"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c03",
                "timeZone": "America/New_York"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The time zone after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "timeZone": {
                      "type": "string",
                      "description": "The key's person's time zone now."
                    }
                  },
                  "required": [
                    "timeZone"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "timeZone": "America/New_York"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_account_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/name": {
      "put": {
        "operationId": "PUT /api/v1/account/name",
        "tags": [
          "profile"
        ],
        "summary": "Change the name",
        "description": "Sets the key's person's name, which everyone in their projects sees.\n\nNobody else can change it. The first time a name is set, the welcomes Werk held until then are sent to the person.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128,
                    "description": "The key's person's new name, which everyone in their projects sees."
                  }
                },
                "required": [
                  "clientRequestId",
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c01",
                "name": "Maya Chen"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The name after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "The key's person's name now."
                    }
                  },
                  "required": [
                    "name"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "name": "Maya Chen"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_account_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/people": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/people",
        "tags": [
          "people"
        ],
        "summary": "List a project's people",
        "description": "The project's people, each with their role, their email and what the key's person may do to them.\n\nEveryone in the project sees each person's verified email.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The project's people.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "capabilities": {
                      "type": "object",
                      "properties": {
                        "invite": {
                          "type": "boolean",
                          "description": "True when the key's person may invite people to the project."
                        },
                        "managePeople": {
                          "type": "boolean",
                          "description": "True when they may manage the project's people."
                        },
                        "changeRoles": {
                          "type": "boolean",
                          "description": "True when they may make a person an admin or a member."
                        },
                        "removePeople": {
                          "type": "boolean",
                          "description": "True when they may remove people from the project."
                        },
                        "editLists": {
                          "type": "boolean",
                          "description": "True when they may change the project's steps."
                        },
                        "archive": {
                          "type": "boolean",
                          "description": "True when they may archive the project."
                        },
                        "restore": {
                          "type": "boolean",
                          "description": "True when they may bring the project back from the archive."
                        },
                        "delete": {
                          "type": "boolean",
                          "description": "True when they may delete the project."
                        },
                        "transferOwnership": {
                          "type": "boolean",
                          "description": "True when they may hand the project to another person and leave it."
                        },
                        "rename": {
                          "type": "boolean",
                          "description": "True when they may rename the project."
                        },
                        "changePhoto": {
                          "type": "boolean",
                          "description": "True when they may change the project's photo."
                        },
                        "leave": {
                          "type": "boolean",
                          "description": "True when they may leave the project."
                        }
                      },
                      "required": [
                        "invite",
                        "managePeople",
                        "changeRoles",
                        "removePeople",
                        "editLists",
                        "archive",
                        "restore",
                        "delete",
                        "transferOwnership",
                        "rename",
                        "changePhoto",
                        "leave"
                      ],
                      "additionalProperties": false,
                      "description": "What the key's person may do with the project now."
                    },
                    "peopleVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The version of the project's people, which changes whenever its people do."
                    },
                    "people": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The person's id."
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 128,
                            "description": "The person's name, as they set it."
                          },
                          "role": {
                            "type": "string",
                            "enum": [
                              "owner",
                              "admin",
                              "member",
                              "collaborator"
                            ],
                            "description": "The person's role in the project."
                          },
                          "form": {
                            "type": "string",
                            "enum": [
                              "feminine",
                              "masculine"
                            ],
                            "description": "The grammatical gender of the person's role name in the reader's language; not sent today."
                          },
                          "email": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "address",
                                    "description": "address for an email shown as is, private_relay for an Apple address the person keeps hidden."
                                  },
                                  "address": {
                                    "type": "string",
                                    "format": "email",
                                    "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
                                    "description": "The email address."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "address"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "private_relay",
                                    "description": "address for an email shown as is, private_relay for an Apple address the person keeps hidden."
                                  }
                                },
                                "required": [
                                  "kind"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "The person's verified email, which everyone in the project sees."
                          },
                          "isYou": {
                            "type": "boolean",
                            "description": "True for the key's own person."
                          },
                          "actions": {
                            "type": "object",
                            "properties": {
                              "changeRoleTo": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "admin",
                                    "member"
                                  ]
                                },
                                "description": "The roles the key's person may give this person now."
                              },
                              "remove": {
                                "type": "boolean",
                                "description": "True when the key's person may remove this person from the project."
                              },
                              "receiveOwnership": {
                                "type": "boolean",
                                "description": "True when the key's person may hand the project to this person and leave it."
                              }
                            },
                            "required": [
                              "changeRoleTo",
                              "remove",
                              "receiveOwnership"
                            ],
                            "additionalProperties": false,
                            "description": "What the key's person may do to this person now."
                          },
                          "photo": {
                            "type": "object",
                            "properties": {
                              "personId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person whose photo it is."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                              }
                            },
                            "required": [
                              "personId",
                              "version"
                            ],
                            "additionalProperties": false,
                            "description": "The person's photo, when they have one."
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "role",
                          "isYou"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The project's people."
                    },
                    "configVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The version of the project's settings; leaving a project as its owner sends it as expectedConfigVersion."
                    }
                  },
                  "required": [
                    "people",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "capabilities": {
                    "invite": true,
                    "managePeople": true,
                    "changeRoles": true,
                    "removePeople": true,
                    "editLists": true,
                    "archive": true,
                    "restore": false,
                    "delete": true,
                    "transferOwnership": true,
                    "rename": true,
                    "changePhoto": true,
                    "leave": true
                  },
                  "peopleVersion": 3,
                  "configVersion": 6,
                  "people": [
                    {
                      "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "name": "Maya Chen",
                      "role": "owner",
                      "email": {
                        "kind": "address",
                        "address": "maya@harborstreet.example"
                      },
                      "isYou": true,
                      "photo": {
                        "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "version": 1
                      }
                    },
                    {
                      "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "name": "Tom Okafor",
                      "role": "admin",
                      "email": {
                        "kind": "address",
                        "address": "tom@harborstreet.example"
                      },
                      "isYou": false,
                      "actions": {
                        "changeRoleTo": [
                          "member"
                        ],
                        "remove": true,
                        "receiveOwnership": true
                      }
                    },
                    {
                      "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                      "name": "Lucia Ferraro",
                      "role": "member",
                      "email": {
                        "kind": "address",
                        "address": "lucia@harborstreet.example"
                      },
                      "isYou": false,
                      "actions": {
                        "changeRoleTo": [
                          "admin"
                        ],
                        "remove": true,
                        "receiveOwnership": true
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/invitations": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/invitations",
        "tags": [
          "people"
        ],
        "summary": "List invitation codes",
        "description": "The invitation codes the key's person made for the project that are still unused, oldest first.\n\nA code itself is shown only once, when it is made.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "responses": {
          "200": {
            "description": "The codes still waiting.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "invitations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The invitation's id."
                          },
                          "expiresAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the code stops working."
                          }
                        },
                        "required": [
                          "id",
                          "expiresAt"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The project's invitation codes still waiting to be used."
                    }
                  },
                  "required": [
                    "invitations"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "invitations": [
                    {
                      "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                      "expiresAt": "2026-11-22T14:05:00.000Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/invitations",
        "tags": [
          "people"
        ],
        "summary": "Create an invitation code",
        "description": "Makes a one-time code that joins the project, valid 24 hours.\n\nThe key's person passes it on however they like; the invited person enters it to join, and nobody is told until then. A person makes at most 20 codes an hour across their projects.",
        "x-werk-group": "create",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d04"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The new code.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "invitation": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The invitation's id."
                        },
                        "expiresAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the code stops working, 24 hours after it was made."
                        }
                      },
                      "required": [
                        "id",
                        "expiresAt"
                      ],
                      "additionalProperties": false,
                      "description": "The new invitation."
                    },
                    "code": {
                      "type": "string",
                      "pattern": "^[0-9A-HJKMNP-TV-Z]{3}-[0-9A-HJKMNP-TV-Z]{3}$",
                      "description": "The invitation code, shown once: the invited person enters it to join, as a member or as a collaborator when they have no plan of their own."
                    },
                    "project": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The id Werk's apps use for the key's person's view of the project, not the project's id."
                        },
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id, the one the API's paths take."
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The project's name."
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "additionalProperties": false,
                      "description": "The project the code joins."
                    }
                  },
                  "required": [
                    "invitation",
                    "code",
                    "project"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "invitation": {
                    "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                    "expiresAt": "2026-11-22T14:05:00.000Z"
                  },
                  "code": "K7M-4QX",
                  "project": {
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "name": "Harbor Street kitchen"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "code_key_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/invitations/{invitationId}/replace": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/invitations/:invitationId/replace",
        "tags": [
          "people"
        ],
        "summary": "Replace an invitation code",
        "description": "Cancels one of the key's person's unused codes and makes a new one in its place.\n\nThe new code counts toward the 20 an hour.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "invitationId",
            "in": "path",
            "required": true,
            "description": "The invitation's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d05"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The new code.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "invitation": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The invitation's id."
                        },
                        "expiresAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the code stops working, 24 hours after it was made."
                        }
                      },
                      "required": [
                        "id",
                        "expiresAt"
                      ],
                      "additionalProperties": false,
                      "description": "The new invitation."
                    },
                    "code": {
                      "type": "string",
                      "pattern": "^[0-9A-HJKMNP-TV-Z]{3}-[0-9A-HJKMNP-TV-Z]{3}$",
                      "description": "The invitation code, shown once: the invited person enters it to join, as a member or as a collaborator when they have no plan of their own."
                    },
                    "project": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The id Werk's apps use for the key's person's view of the project, not the project's id."
                        },
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id, the one the API's paths take."
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "description": "The project's name."
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "additionalProperties": false,
                      "description": "The project the code joins."
                    }
                  },
                  "required": [
                    "invitation",
                    "code",
                    "project"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "invitation": {
                    "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                    "expiresAt": "2026-11-22T14:05:00.000Z"
                  },
                  "code": "R2D-9VN",
                  "project": {
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "name": "Harbor Street kitchen"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "code_key_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/invitations/{invitationId}": {
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/invitations/:invitationId",
        "tags": [
          "people"
        ],
        "summary": "Cancel an invitation code",
        "description": "Cancels one of the key's person's unused codes, so it no longer joins.\n\nA person may always cancel their own codes.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "invitationId",
            "in": "path",
            "required": true,
            "description": "The invitation's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d06"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The code is cancelled."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/invitations/redeem": {
      "post": {
        "operationId": "POST /api/v1/invitations/redeem",
        "tags": [
          "projects"
        ],
        "summary": "Join with an invitation code",
        "description": "Joins the key's person to a project with an invitation code someone in it gave them.\n\nThe person who made the code is told. A code that is unknown, used or cancelled answers kind refused, and one past its 24 hours kind expired.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "code": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 16,
                    "description": "The invitation code, as given."
                  }
                },
                "required": [
                  "clientRequestId",
                  "code"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b07",
                "code": "K7M-4QX"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What came of the code.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "joined",
                          "description": "joined when the key's person is in the project now, refused when the code does not join, expired when it ran out."
                        },
                        "project": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The id Werk's apps use for the key's person's view of the project, not the project's id."
                            },
                            "projectId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The project's id, the one the API's paths take."
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128,
                              "description": "The project's name."
                            }
                          },
                          "required": [
                            "id",
                            "name"
                          ],
                          "additionalProperties": false,
                          "description": "The project joined."
                        },
                        "role": {
                          "type": "string",
                          "enum": [
                            "owner",
                            "admin",
                            "member",
                            "collaborator"
                          ],
                          "description": "The key's person's role in the project."
                        },
                        "form": {
                          "type": "string",
                          "enum": [
                            "feminine",
                            "masculine"
                          ],
                          "description": "The grammatical gender of the role's name in the reader's language; not sent today."
                        },
                        "alreadyMember": {
                          "type": "boolean",
                          "description": "True when the key's person was already in the project."
                        },
                        "welcomeContext": {
                          "type": "object",
                          "properties": {
                            "firstWelcomeOfAccount": {
                              "type": "boolean",
                              "description": "True when this is the first project the account is welcomed to."
                            }
                          },
                          "required": [
                            "firstWelcomeOfAccount"
                          ],
                          "additionalProperties": false,
                          "description": "About the welcome Werk sends on joining."
                        }
                      },
                      "required": [
                        "kind",
                        "project",
                        "role",
                        "alreadyMember"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "refused",
                          "description": "joined when the key's person is in the project now, refused when the code does not join, expired when it ran out."
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "expired",
                          "description": "joined when the key's person is in the project now, refused when the code does not join, expired when it ran out."
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "kind": "joined",
                  "project": {
                    "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "name": "Harbor Street kitchen"
                  },
                  "role": "member",
                  "alreadyMember": false,
                  "welcomeContext": {
                    "firstWelcomeOfAccount": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/joins": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/joins",
        "tags": [
          "people"
        ],
        "summary": "List joins by code",
        "description": "The people who joined the project with the key's person's invitation codes and are still in it.\n\nOldest first.",
        "x-werk-group": "read",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The joins.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "joins": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The notice's id."
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 128,
                            "description": "The name of the person who joined."
                          },
                          "project": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id Werk's apps use for the key's person's view of the project, not the project's id."
                              },
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project's id, the one the API's paths take."
                              },
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128,
                                "description": "The project's name."
                              }
                            },
                            "required": [
                              "id",
                              "name"
                            ],
                            "additionalProperties": false,
                            "description": "The project they joined."
                          },
                          "joinedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When they joined."
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "project",
                          "joinedAt"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Notices that someone joined one of the key's person's projects with an invitation."
                    }
                  },
                  "required": [
                    "joins"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "joins": [
                    {
                      "id": "d2a6c0e4-9b3f-4d5b-87a9-2b8c0f4d6a08",
                      "name": "Lucia Ferraro",
                      "project": {
                        "id": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                        "name": "Harbor Street kitchen"
                      },
                      "joinedAt": "2026-11-19T10:00:00.000Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/people/{personId}": {
      "patch": {
        "operationId": "PATCH /api/v1/projects/:projectId/people/:personId",
        "tags": [
          "people"
        ],
        "summary": "Change a person's role",
        "description": "Makes a person of the project an admin, or an admin a member.\n\nThe owner and the admins allowed to name admins may do it. A person who is not in the project is refused as not_permitted.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "personId",
            "in": "path",
            "required": true,
            "description": "The person's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "role": {
                    "type": "string",
                    "enum": [
                      "admin",
                      "member"
                    ],
                    "description": "The person's new role."
                  }
                },
                "required": [
                  "clientRequestId",
                  "role"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d01",
                "role": "admin"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project's people after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "capabilities": {
                      "type": "object",
                      "properties": {
                        "invite": {
                          "type": "boolean",
                          "description": "True when the key's person may invite people to the project."
                        },
                        "managePeople": {
                          "type": "boolean",
                          "description": "True when they may manage the project's people."
                        },
                        "changeRoles": {
                          "type": "boolean",
                          "description": "True when they may make a person an admin or a member."
                        },
                        "removePeople": {
                          "type": "boolean",
                          "description": "True when they may remove people from the project."
                        },
                        "editLists": {
                          "type": "boolean",
                          "description": "True when they may change the project's steps."
                        },
                        "archive": {
                          "type": "boolean",
                          "description": "True when they may archive the project."
                        },
                        "restore": {
                          "type": "boolean",
                          "description": "True when they may bring the project back from the archive."
                        },
                        "delete": {
                          "type": "boolean",
                          "description": "True when they may delete the project."
                        },
                        "transferOwnership": {
                          "type": "boolean",
                          "description": "True when they may hand the project to another person and leave it."
                        },
                        "rename": {
                          "type": "boolean",
                          "description": "True when they may rename the project."
                        },
                        "changePhoto": {
                          "type": "boolean",
                          "description": "True when they may change the project's photo."
                        },
                        "leave": {
                          "type": "boolean",
                          "description": "True when they may leave the project."
                        }
                      },
                      "required": [
                        "invite",
                        "managePeople",
                        "changeRoles",
                        "removePeople",
                        "editLists",
                        "archive",
                        "restore",
                        "delete",
                        "transferOwnership",
                        "rename",
                        "changePhoto",
                        "leave"
                      ],
                      "additionalProperties": false,
                      "description": "What the key's person may do with the project now."
                    },
                    "peopleVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The version of the project's people, which changes whenever its people do."
                    },
                    "people": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The person's id."
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 128,
                            "description": "The person's name, as they set it."
                          },
                          "role": {
                            "type": "string",
                            "enum": [
                              "owner",
                              "admin",
                              "member",
                              "collaborator"
                            ],
                            "description": "The person's role in the project."
                          },
                          "form": {
                            "type": "string",
                            "enum": [
                              "feminine",
                              "masculine"
                            ],
                            "description": "The grammatical gender of the person's role name in the reader's language; not sent today."
                          },
                          "email": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "address",
                                    "description": "address for an email shown as is, private_relay for an Apple address the person keeps hidden."
                                  },
                                  "address": {
                                    "type": "string",
                                    "format": "email",
                                    "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
                                    "description": "The email address."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "address"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "private_relay",
                                    "description": "address for an email shown as is, private_relay for an Apple address the person keeps hidden."
                                  }
                                },
                                "required": [
                                  "kind"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "The person's verified email, which everyone in the project sees."
                          },
                          "isYou": {
                            "type": "boolean",
                            "description": "True for the key's own person."
                          },
                          "actions": {
                            "type": "object",
                            "properties": {
                              "changeRoleTo": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "admin",
                                    "member"
                                  ]
                                },
                                "description": "The roles the key's person may give this person now."
                              },
                              "remove": {
                                "type": "boolean",
                                "description": "True when the key's person may remove this person from the project."
                              },
                              "receiveOwnership": {
                                "type": "boolean",
                                "description": "True when the key's person may hand the project to this person and leave it."
                              }
                            },
                            "required": [
                              "changeRoleTo",
                              "remove",
                              "receiveOwnership"
                            ],
                            "additionalProperties": false,
                            "description": "What the key's person may do to this person now."
                          },
                          "photo": {
                            "type": "object",
                            "properties": {
                              "personId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person whose photo it is."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                              }
                            },
                            "required": [
                              "personId",
                              "version"
                            ],
                            "additionalProperties": false,
                            "description": "The person's photo, when they have one."
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "role",
                          "isYou"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The project's people."
                    },
                    "configVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The version of the project's settings; leaving a project as its owner sends it as expectedConfigVersion."
                    }
                  },
                  "required": [
                    "people",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "peopleVersion": 3,
                  "configVersion": 6,
                  "people": [
                    {
                      "id": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "name": "Maya Chen",
                      "role": "owner",
                      "email": {
                        "kind": "address",
                        "address": "maya@harborstreet.example"
                      },
                      "isYou": true,
                      "photo": {
                        "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                        "version": 1
                      }
                    },
                    {
                      "id": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "name": "Tom Okafor",
                      "role": "admin",
                      "email": {
                        "kind": "address",
                        "address": "tom@harborstreet.example"
                      },
                      "isYou": false,
                      "actions": {
                        "changeRoleTo": [
                          "member"
                        ],
                        "remove": true,
                        "receiveOwnership": true
                      }
                    },
                    {
                      "id": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64",
                      "name": "Lucia Ferraro",
                      "role": "member",
                      "email": {
                        "kind": "address",
                        "address": "lucia@harborstreet.example"
                      },
                      "isYou": false,
                      "actions": {
                        "changeRoleTo": [
                          "admin"
                        ],
                        "remove": true,
                        "receiveOwnership": true
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "person_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/people/:personId",
        "tags": [
          "people"
        ],
        "summary": "Remove a person",
        "description": "Takes a person out of the project.\n\nWhat they recorded stays, and the cards they held become free. Only those who may manage admins remove an admin.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "personId",
            "in": "path",
            "required": true,
            "description": "The person's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "c4b7e9a1-2d6f-4c83-b5a0-7e1f3d9c2b64"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d02"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The person is out of the project."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "person_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/leave": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/leave",
        "tags": [
          "people"
        ],
        "summary": "Leave a project",
        "description": "Takes the key's person out of the project.\n\nThe cards they held become free. The owner leaves only by handing the project to another person in it, named with transferToUserId; My Werk cannot be left.",
        "x-werk-group": "change",
        "x-werk-area": "people",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "clientRequestId": {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                        "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                      }
                    },
                    "required": [
                      "clientRequestId"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "clientRequestId": {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                        "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                      },
                      "transferToUserId": {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                        "description": "For the owner, the person of the project who becomes its owner."
                      },
                      "expectedConfigVersion": {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991,
                        "description": "For the owner, the project's configVersion as last read; when it changed since, the request is refused."
                      }
                    },
                    "required": [
                      "clientRequestId",
                      "transferToUserId",
                      "expectedConfigVersion"
                    ],
                    "additionalProperties": false
                  }
                ]
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4d03",
                "transferToUserId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                "expectedConfigVersion": 6
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The key's person is out of the project."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_people_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_permitted",
              "personal_project_restricted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/numbers/{number}": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/numbers/:number",
        "tags": [
          "cards"
        ],
        "summary": "Get a card by number",
        "description": "The card a project knows by its number, archived cards included.\n\nNumbers count per project and are never reused there.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "number",
            "in": "path",
            "required": true,
            "description": "The card's number, without its #.",
            "schema": {
              "type": "string",
              "pattern": "^[1-9]\\d{0,15}$"
            },
            "example": "12"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The card.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "item": {
                      "type": "object",
                      "properties": {
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "open",
                            "completed",
                            "not_completed"
                          ],
                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card's id."
                        },
                        "ref": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's number as people write it, with # before it."
                        },
                        "title": {
                          "type": "string",
                          "description": "The card's title, as written."
                        },
                        "language": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The language the card's title and description are written in."
                        },
                        "titleTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The title in the reader's language, when it is written in another."
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The id of the step the card is on."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "The step's name."
                            },
                            "category": {
                              "type": "string",
                              "enum": [
                                "open",
                                "active",
                                "done"
                              ],
                              "description": "open on a new step, done on the project's last step, active on any other step."
                            },
                            "bucket": {
                              "type": "string",
                              "enum": [
                                "new",
                                "in_progress",
                                "waiting",
                                "resolved",
                                "closed"
                              ],
                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                            },
                            "labelLanguage": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                            },
                            "labelTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The step's name in the reader's language, when it is written in another."
                            }
                          },
                          "required": [
                            "key",
                            "label",
                            "category"
                          ],
                          "additionalProperties": false,
                          "description": "The step the card is on, with where that step sits in the work."
                        },
                        "dueNoticeLead": {
                          "type": "string",
                          "enum": [
                            "none",
                            "at_due",
                            "15_minutes",
                            "1_hour",
                            "2_hours",
                            "1_day",
                            "2_days"
                          ],
                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                        },
                        "dueSetBy": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "displayName": {
                                  "type": "string",
                                  "description": "That person's name."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who set the due moment; present only for a due date with a time."
                        },
                        "due": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "date",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "date": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The due day, as YYYY-MM-DD."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "date"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "datetime",
                                      "description": "date for a due day with no time, datetime for a due moment."
                                    },
                                    "at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                    },
                                    "enteredTimeZone": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The time zone the due moment was given in, when known."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's due date, or null when it has none."
                        },
                        "assignee": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The holder's person id."
                                },
                                "displayName": {
                                  "type": "string",
                                  "description": "The holder's name as the project shows it."
                                },
                                "initials": {
                                  "type": "string",
                                  "description": "The holder's initials, for an avatar with no photo."
                                },
                                "photo": {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The person whose photo it is."
                                    },
                                    "version": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                    }
                                  },
                                  "required": [
                                    "personId",
                                    "version"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The holder's photo, when they have one."
                                }
                              },
                              "required": [
                                "displayName"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's holder, or null when the card is free."
                        },
                        "version": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991,
                          "description": "The card's version, which grows with every change to it."
                        },
                        "number": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's number in its project, unique there and never reused."
                        },
                        "currentStep": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's id; a change of step sends it as stepId."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "id",
                                "label",
                                "bucket"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The card's step among its project's steps, as the project defines it."
                        },
                        "archived": {
                          "type": "boolean",
                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "photos": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Photos on the card."
                            },
                            "updates": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Updates on the card."
                            },
                            "documents": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Documents on the card."
                            },
                            "checklist": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                            }
                          },
                          "required": [
                            "photos",
                            "updates",
                            "documents"
                          ],
                          "additionalProperties": false,
                          "description": "How much the card holds."
                        },
                        "allowedActions": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "take_card",
                              "assign_card",
                              "give_back_card",
                              "move_card",
                              "archive_card",
                              "unarchive_card",
                              "edit_card",
                              "set_card_due",
                              "add_update",
                              "create_reminder",
                              "link_duplicate",
                              "add_entries",
                              "rename_entry",
                              "remove_entry",
                              "reorder_entries",
                              "follow_card",
                              "unfollow_card",
                              "follow_invitation",
                              "tick_entry",
                              "untick_entry",
                              "set_due_notice"
                            ]
                          },
                          "description": "The changes the key's person may make to this card by hand now, by action name."
                        }
                      },
                      "required": [
                        "id",
                        "ref",
                        "title",
                        "status",
                        "due",
                        "assignee",
                        "version"
                      ],
                      "additionalProperties": false,
                      "description": "The card as the key's person reads it after the change."
                    }
                  },
                  "required": [
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "item": {
                    "outcome": "open",
                    "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "ref": "#12",
                    "title": "Replace the leaking sink faucet",
                    "language": "en-US",
                    "status": {
                      "key": "waiting_parts",
                      "label": "Waiting for parts",
                      "category": "active",
                      "bucket": "waiting"
                    },
                    "dueNoticeLead": "at_due",
                    "due": null,
                    "assignee": {
                      "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO"
                    },
                    "version": 4,
                    "number": 12,
                    "currentStep": {
                      "id": "waiting_parts",
                      "label": "Waiting for parts",
                      "bucket": "waiting"
                    },
                    "archived": false,
                    "counts": {
                      "photos": 1,
                      "updates": 1,
                      "documents": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/updates/{updateId}/photos": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/updates/:updateId/photos",
        "tags": [
          "cards"
        ],
        "summary": "List an update's photos",
        "description": "One page of the photos that came with one of a card's updates.\n\nAn update shows its first photos within the card; this reads the rest.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "updateId",
            "in": "path",
            "required": true,
            "description": "The update's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "c9a3e7f1-4d6b-4f80-a2c8-5b1e9d3f7a46"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many photos a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The page of photos.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "entries": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The photo's id on the card; removing it names this id."
                          },
                          "attachedBy": {
                            "anyOf": [
                              {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "user",
                                        "description": "user for a person; connector or schedule for a change Werk made without one."
                                      },
                                      "displayName": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The person's name as the project shows it."
                                      },
                                      "initials": {
                                        "type": "string",
                                        "description": "The person's initials, for an avatar with no photo."
                                      },
                                      "isViewer": {
                                        "type": "boolean",
                                        "description": "True when the person is the key's own person."
                                      },
                                      "photo": {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person whose photo it is."
                                          },
                                          "version": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                          }
                                        },
                                        "required": [
                                          "personId",
                                          "version"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The person's photo, when they have one."
                                      },
                                      "via": {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "enum": [
                                              "connection",
                                              "key"
                                            ],
                                            "description": "connection for an app connected by sign-in, key for an API key."
                                          },
                                          "name": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The app's or the key's name, as Werk shows it."
                                          },
                                          "verified": {
                                            "type": "boolean",
                                            "description": "True when Werk verified the app's identity."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The caption Werk shows beside the change, in the reader's language."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "name",
                                          "verified",
                                          "label"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "displayName",
                                      "initials",
                                      "isViewer"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "connector",
                                        "description": "user for a person; connector or schedule for a change Werk made without one."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The name Werk shows for a change made without a person."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "label"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "schedule",
                                        "description": "user for a person; connector or schedule for a change Werk made without one."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The name Werk shows for a change made without a person."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "label"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Who added the photo, or null when no longer known."
                          },
                          "asset": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The file's id."
                              },
                              "kind": {
                                "type": "string",
                                "const": "image",
                                "description": "What the file is: a photo, a voice recording or a document."
                              },
                              "filename": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 255,
                                "description": "The document's name; only a document has one."
                              },
                              "format": {
                                "type": "string",
                                "enum": [
                                  "pdf",
                                  "docx",
                                  "xlsx",
                                  "csv",
                                  "txt",
                                  "md"
                                ],
                                "description": "The document's format; only a document has one."
                              },
                              "mimeType": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The file's media type."
                              },
                              "sizeBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The file's size in bytes."
                              },
                              "width": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                              },
                              "height": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                              },
                              "durationSeconds": {
                                "type": "number",
                                "exclusiveMinimum": 0,
                                "maximum": 300,
                                "description": "The recording's length in seconds; only a voice recording has one."
                              },
                              "available": {
                                "type": "boolean",
                                "description": "False once the file's bytes were released and it can no longer be read."
                              }
                            },
                            "required": [
                              "id",
                              "kind",
                              "mimeType",
                              "sizeBytes"
                            ],
                            "additionalProperties": false,
                            "description": "The photo's file."
                          },
                          "attachedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the photo was added to the card."
                          },
                          "removable": {
                            "type": "boolean",
                            "description": "True when the key's person may take this photo off the card now."
                          }
                        },
                        "required": [
                          "id",
                          "attachedBy",
                          "asset",
                          "attachedAt",
                          "removable"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The photos on this page, newest first."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "True when older photos remain past this page."
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The cursor that reads the next page, or null when none remains."
                    }
                  },
                  "required": [
                    "entries",
                    "hasMore",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "entries": [
                    {
                      "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                      "attachedBy": {
                        "kind": "user",
                        "displayName": "Tom Okafor",
                        "initials": "TO",
                        "isViewer": false
                      },
                      "asset": {
                        "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                        "kind": "image",
                        "mimeType": "image/jpeg",
                        "sizeBytes": 482113,
                        "width": 1600,
                        "height": 1200
                      },
                      "attachedAt": "2026-11-19T16:12:00.000Z",
                      "removable": true
                    }
                  ],
                  "hasMore": false,
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_cursor"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "update_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/agenda": {
      "get": {
        "operationId": "GET /api/v1/agenda",
        "tags": [
          "reminders"
        ],
        "summary": "List the agenda",
        "description": "What is due for the key's person, day by day: their reminders and the due dates of the cards they hold or follow.\n\nOverdue entries come first, then each day in order. Done and archived cards are left out. Without before, the agenda covers 14 days from today.",
        "x-werk-group": "read",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many entries a page holds.",
            "schema": {
              "default": 100,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "50"
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "The first day left out, as YYYY-MM-DD in the key's person's time zone, after today; left out, 14 days from today.",
            "schema": {
              "type": "string",
              "format": "date",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The agenda's page.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The cursor that reads the next page, or null when none remains."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "True when more entries remain past this page."
                    },
                    "timeZone": {
                      "type": "string",
                      "description": "The key's person's time zone, which the days are read in."
                    },
                    "today": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                      "description": "Today in that time zone."
                    },
                    "through": {
                      "type": "string",
                      "format": "date",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                      "description": "The last day the agenda covers."
                    },
                    "overdue": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project the entry is in."
                              },
                              "conversationId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                              },
                              "item": {
                                "type": "object",
                                "properties": {
                                  "outcome": {
                                    "type": "string",
                                    "enum": [
                                      "open",
                                      "completed",
                                      "not_completed"
                                    ],
                                    "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                                  },
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The card's id."
                                  },
                                  "ref": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The card's number as people write it, with # before it."
                                  },
                                  "title": {
                                    "type": "string",
                                    "description": "The card's title, as written."
                                  },
                                  "language": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The language the card's title and description are written in."
                                  },
                                  "titleTranslation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The title in the reader's language, when it is written in another."
                                  },
                                  "status": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The id of the step the card is on."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The step's name."
                                      },
                                      "category": {
                                        "type": "string",
                                        "enum": [
                                          "open",
                                          "active",
                                          "done"
                                        ],
                                        "description": "open on a new step, done on the project's last step, active on any other step."
                                      },
                                      "bucket": {
                                        "type": "string",
                                        "enum": [
                                          "new",
                                          "in_progress",
                                          "waiting",
                                          "resolved",
                                          "closed"
                                        ],
                                        "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                      },
                                      "labelLanguage": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                      },
                                      "labelTranslation": {
                                        "type": "object",
                                        "properties": {
                                          "language": {
                                            "type": "string",
                                            "minLength": 2,
                                            "maxLength": 64,
                                            "description": "The reader's language the text is translated into."
                                          },
                                          "state": {
                                            "type": "string",
                                            "enum": [
                                              "ready",
                                              "pending",
                                              "failed",
                                              "paused"
                                            ],
                                            "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                          },
                                          "text": {
                                            "type": "string",
                                            "description": "The translated text, present once ready."
                                          }
                                        },
                                        "required": [
                                          "language",
                                          "state"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The step's name in the reader's language, when it is written in another."
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "label",
                                      "category"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The step the card is on, with where that step sits in the work."
                                  },
                                  "dueNoticeLead": {
                                    "type": "string",
                                    "enum": [
                                      "none",
                                      "at_due",
                                      "15_minutes",
                                      "1_hour",
                                      "2_hours",
                                      "1_day",
                                      "2_days"
                                    ],
                                    "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                                  },
                                  "dueSetBy": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "displayName": {
                                            "type": "string",
                                            "description": "That person's name."
                                          }
                                        },
                                        "required": [
                                          "displayName"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who set the due moment; present only for a due date with a time."
                                  },
                                  "due": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "date",
                                                "description": "date for a due day with no time, datetime for a due moment."
                                              },
                                              "date": {
                                                "type": "string",
                                                "format": "date",
                                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                "description": "The due day, as YYYY-MM-DD."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "date"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "datetime",
                                                "description": "date for a due day with no time, datetime for a due moment."
                                              },
                                              "at": {
                                                "type": "string",
                                                "format": "date-time",
                                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                                "description": "The due moment, as an ISO 8601 date and time with its offset."
                                              },
                                              "enteredTimeZone": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "description": "The time zone the due moment was given in, when known."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "at"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's due date, or null when it has none."
                                  },
                                  "assignee": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The holder's person id."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "description": "The holder's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The holder's initials, for an avatar with no photo."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The holder's photo, when they have one."
                                          }
                                        },
                                        "required": [
                                          "displayName"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's holder, or null when the card is free."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991,
                                    "description": "The card's version, which grows with every change to it."
                                  },
                                  "number": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's number in its project, unique there and never reused."
                                  },
                                  "currentStep": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The step's id; a change of step sends it as stepId."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The step's name."
                                          },
                                          "bucket": {
                                            "type": "string",
                                            "enum": [
                                              "new",
                                              "in_progress",
                                              "waiting",
                                              "resolved",
                                              "closed"
                                            ],
                                            "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                          },
                                          "labelLanguage": {
                                            "type": "string",
                                            "minLength": 2,
                                            "maxLength": 64,
                                            "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                          },
                                          "labelTranslation": {
                                            "type": "object",
                                            "properties": {
                                              "language": {
                                                "type": "string",
                                                "minLength": 2,
                                                "maxLength": 64,
                                                "description": "The reader's language the text is translated into."
                                              },
                                              "state": {
                                                "type": "string",
                                                "enum": [
                                                  "ready",
                                                  "pending",
                                                  "failed",
                                                  "paused"
                                                ],
                                                "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                              },
                                              "text": {
                                                "type": "string",
                                                "description": "The translated text, present once ready."
                                              }
                                            },
                                            "required": [
                                              "language",
                                              "state"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The step's name in the reader's language, when it is written in another."
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "label",
                                          "bucket"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's step among its project's steps, as the project defines it."
                                  },
                                  "archived": {
                                    "type": "boolean",
                                    "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                                  },
                                  "counts": {
                                    "type": "object",
                                    "properties": {
                                      "photos": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "Photos on the card."
                                      },
                                      "updates": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "Updates on the card."
                                      },
                                      "documents": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "Documents on the card."
                                      },
                                      "checklist": {
                                        "type": "object",
                                        "properties": {
                                          "done": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "List items checked."
                                          },
                                          "total": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "List items in all."
                                          }
                                        },
                                        "required": [
                                          "done",
                                          "total"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The card's list: its items checked and in all; absent when the card has no list."
                                      }
                                    },
                                    "required": [
                                      "photos",
                                      "updates",
                                      "documents"
                                    ],
                                    "additionalProperties": false,
                                    "description": "How much the card holds."
                                  },
                                  "allowedActions": {
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "enum": [
                                        "take_card",
                                        "assign_card",
                                        "give_back_card",
                                        "move_card",
                                        "archive_card",
                                        "unarchive_card",
                                        "edit_card",
                                        "set_card_due",
                                        "add_update",
                                        "create_reminder",
                                        "link_duplicate",
                                        "add_entries",
                                        "rename_entry",
                                        "remove_entry",
                                        "reorder_entries",
                                        "follow_card",
                                        "unfollow_card",
                                        "follow_invitation",
                                        "tick_entry",
                                        "untick_entry",
                                        "set_due_notice"
                                      ]
                                    },
                                    "description": "The changes the key's person may make to this card by hand now, by action name."
                                  }
                                },
                                "required": [
                                  "id",
                                  "ref",
                                  "title",
                                  "status",
                                  "due",
                                  "assignee",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The card, or null for a reminder with no card."
                              },
                              "day": {
                                "type": "string",
                                "format": "date",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                "description": "The day the entry falls on, in the key's person's time zone."
                              },
                              "overdue": {
                                "type": "boolean",
                                "description": "True when its time has passed."
                              },
                              "destination": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "card",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      },
                                      "itemId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The card's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId",
                                      "itemId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "chat",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      },
                                      "messageId": {
                                        "type": "string",
                                        "pattern": "^out:(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The chat message's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId",
                                      "messageId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "project",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "people",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "cardless_reminders",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "plans",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "pulse",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "description": "Where Werk's apps open the entry."
                              },
                              "kind": {
                                "type": "string",
                                "const": "due",
                                "description": "due for a card's due date, personal_reminder for a reminder on a card, personal_reminder_cardless for one with no card."
                              }
                            },
                            "required": [
                              "projectId",
                              "conversationId",
                              "item",
                              "day",
                              "overdue",
                              "kind"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project the entry is in."
                              },
                              "conversationId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                              },
                              "item": {
                                "type": "object",
                                "properties": {
                                  "outcome": {
                                    "type": "string",
                                    "enum": [
                                      "open",
                                      "completed",
                                      "not_completed"
                                    ],
                                    "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                                  },
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The card's id."
                                  },
                                  "ref": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The card's number as people write it, with # before it."
                                  },
                                  "title": {
                                    "type": "string",
                                    "description": "The card's title, as written."
                                  },
                                  "language": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The language the card's title and description are written in."
                                  },
                                  "titleTranslation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The title in the reader's language, when it is written in another."
                                  },
                                  "status": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The id of the step the card is on."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The step's name."
                                      },
                                      "category": {
                                        "type": "string",
                                        "enum": [
                                          "open",
                                          "active",
                                          "done"
                                        ],
                                        "description": "open on a new step, done on the project's last step, active on any other step."
                                      },
                                      "bucket": {
                                        "type": "string",
                                        "enum": [
                                          "new",
                                          "in_progress",
                                          "waiting",
                                          "resolved",
                                          "closed"
                                        ],
                                        "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                      },
                                      "labelLanguage": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                      },
                                      "labelTranslation": {
                                        "type": "object",
                                        "properties": {
                                          "language": {
                                            "type": "string",
                                            "minLength": 2,
                                            "maxLength": 64,
                                            "description": "The reader's language the text is translated into."
                                          },
                                          "state": {
                                            "type": "string",
                                            "enum": [
                                              "ready",
                                              "pending",
                                              "failed",
                                              "paused"
                                            ],
                                            "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                          },
                                          "text": {
                                            "type": "string",
                                            "description": "The translated text, present once ready."
                                          }
                                        },
                                        "required": [
                                          "language",
                                          "state"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The step's name in the reader's language, when it is written in another."
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "label",
                                      "category"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The step the card is on, with where that step sits in the work."
                                  },
                                  "dueNoticeLead": {
                                    "type": "string",
                                    "enum": [
                                      "none",
                                      "at_due",
                                      "15_minutes",
                                      "1_hour",
                                      "2_hours",
                                      "1_day",
                                      "2_days"
                                    ],
                                    "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                                  },
                                  "dueSetBy": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "displayName": {
                                            "type": "string",
                                            "description": "That person's name."
                                          }
                                        },
                                        "required": [
                                          "displayName"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who set the due moment; present only for a due date with a time."
                                  },
                                  "due": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "date",
                                                "description": "date for a due day with no time, datetime for a due moment."
                                              },
                                              "date": {
                                                "type": "string",
                                                "format": "date",
                                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                "description": "The due day, as YYYY-MM-DD."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "date"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "datetime",
                                                "description": "date for a due day with no time, datetime for a due moment."
                                              },
                                              "at": {
                                                "type": "string",
                                                "format": "date-time",
                                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                                "description": "The due moment, as an ISO 8601 date and time with its offset."
                                              },
                                              "enteredTimeZone": {
                                                "type": [
                                                  "string",
                                                  "null"
                                                ],
                                                "description": "The time zone the due moment was given in, when known."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "at"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's due date, or null when it has none."
                                  },
                                  "assignee": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The holder's person id."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "description": "The holder's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The holder's initials, for an avatar with no photo."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The holder's photo, when they have one."
                                          }
                                        },
                                        "required": [
                                          "displayName"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's holder, or null when the card is free."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991,
                                    "description": "The card's version, which grows with every change to it."
                                  },
                                  "number": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's number in its project, unique there and never reused."
                                  },
                                  "currentStep": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The step's id; a change of step sends it as stepId."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The step's name."
                                          },
                                          "bucket": {
                                            "type": "string",
                                            "enum": [
                                              "new",
                                              "in_progress",
                                              "waiting",
                                              "resolved",
                                              "closed"
                                            ],
                                            "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                          },
                                          "labelLanguage": {
                                            "type": "string",
                                            "minLength": 2,
                                            "maxLength": 64,
                                            "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                          },
                                          "labelTranslation": {
                                            "type": "object",
                                            "properties": {
                                              "language": {
                                                "type": "string",
                                                "minLength": 2,
                                                "maxLength": 64,
                                                "description": "The reader's language the text is translated into."
                                              },
                                              "state": {
                                                "type": "string",
                                                "enum": [
                                                  "ready",
                                                  "pending",
                                                  "failed",
                                                  "paused"
                                                ],
                                                "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                              },
                                              "text": {
                                                "type": "string",
                                                "description": "The translated text, present once ready."
                                              }
                                            },
                                            "required": [
                                              "language",
                                              "state"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The step's name in the reader's language, when it is written in another."
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "label",
                                          "bucket"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The card's step among its project's steps, as the project defines it."
                                  },
                                  "archived": {
                                    "type": "boolean",
                                    "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                                  },
                                  "counts": {
                                    "type": "object",
                                    "properties": {
                                      "photos": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "Photos on the card."
                                      },
                                      "updates": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "Updates on the card."
                                      },
                                      "documents": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "Documents on the card."
                                      },
                                      "checklist": {
                                        "type": "object",
                                        "properties": {
                                          "done": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "List items checked."
                                          },
                                          "total": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "List items in all."
                                          }
                                        },
                                        "required": [
                                          "done",
                                          "total"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The card's list: its items checked and in all; absent when the card has no list."
                                      }
                                    },
                                    "required": [
                                      "photos",
                                      "updates",
                                      "documents"
                                    ],
                                    "additionalProperties": false,
                                    "description": "How much the card holds."
                                  },
                                  "allowedActions": {
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "enum": [
                                        "take_card",
                                        "assign_card",
                                        "give_back_card",
                                        "move_card",
                                        "archive_card",
                                        "unarchive_card",
                                        "edit_card",
                                        "set_card_due",
                                        "add_update",
                                        "create_reminder",
                                        "link_duplicate",
                                        "add_entries",
                                        "rename_entry",
                                        "remove_entry",
                                        "reorder_entries",
                                        "follow_card",
                                        "unfollow_card",
                                        "follow_invitation",
                                        "tick_entry",
                                        "untick_entry",
                                        "set_due_notice"
                                      ]
                                    },
                                    "description": "The changes the key's person may make to this card by hand now, by action name."
                                  }
                                },
                                "required": [
                                  "id",
                                  "ref",
                                  "title",
                                  "status",
                                  "due",
                                  "assignee",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The card, or null for a reminder with no card."
                              },
                              "day": {
                                "type": "string",
                                "format": "date",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                "description": "The day the entry falls on, in the key's person's time zone."
                              },
                              "overdue": {
                                "type": "boolean",
                                "description": "True when its time has passed."
                              },
                              "destination": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "card",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      },
                                      "itemId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The card's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId",
                                      "itemId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "chat",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      },
                                      "messageId": {
                                        "type": "string",
                                        "pattern": "^out:(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The chat message's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId",
                                      "messageId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "project",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "people",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "cardless_reminders",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "plans",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "pulse",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "description": "Where Werk's apps open the entry."
                              },
                              "kind": {
                                "type": "string",
                                "const": "personal_reminder",
                                "description": "due for a card's due date, personal_reminder for a reminder on a card, personal_reminder_cardless for one with no card."
                              },
                              "reminder": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The reminder's id."
                                  },
                                  "itemId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The card the reminder is on."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                                  },
                                  "timeRevision": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                                  },
                                  "snoozeRevision": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                                  },
                                  "fireAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The time its owner set the reminder for."
                                  },
                                  "effectiveFireAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                                  },
                                  "snoozedUntil": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The time the key's person snoozed the reminder to, or null."
                                  },
                                  "setterTimeZone": {
                                    "type": "string",
                                    "description": "The time zone the reminder's time was set in."
                                  },
                                  "text": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The reminder's text, as its owner wrote it."
                                  },
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The language a shared reminder's text is written in."
                                  },
                                  "translation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A shared reminder's text in the reader's language, when it is written in another."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "upcoming",
                                      "past",
                                      "dropped"
                                    ],
                                    "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                                  },
                                  "audience": {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "enum": [
                                          "only_you",
                                          "invited_by_you",
                                          "from_owner"
                                        ],
                                        "description": "only_you for the key's person's own reminder shared with nobody, invited_by_you for their own reminder shared with others, from_owner for a reminder someone shared with them."
                                      },
                                      "label": {
                                        "type": "string",
                                        "description": "Who the reminder is for, in one line in the reader's language."
                                      },
                                      "owner": {
                                        "type": "object",
                                        "properties": {
                                          "userId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person's id."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          }
                                        },
                                        "required": [
                                          "userId",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The person who set the reminder."
                                      },
                                      "invited": {
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "userId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person's id."
                                            },
                                            "displayName": {
                                              "type": "string",
                                              "description": "The person's name as the project shows it."
                                            },
                                            "initials": {
                                              "type": "string",
                                              "description": "The person's initials, for an avatar with no photo."
                                            },
                                            "isViewer": {
                                              "type": "boolean",
                                              "description": "True when the person is the key's own person."
                                            },
                                            "photo": {
                                              "type": "object",
                                              "properties": {
                                                "personId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The person whose photo it is."
                                                },
                                                "version": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                }
                                              },
                                              "required": [
                                                "personId",
                                                "version"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The person's photo, when they have one."
                                            }
                                          },
                                          "required": [
                                            "userId",
                                            "displayName",
                                            "initials",
                                            "isViewer"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "description": "The people the owner shared the reminder with who accepted it."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "label",
                                      "owner",
                                      "invited"
                                    ],
                                    "additionalProperties": false,
                                    "description": "Whose reminder it is and who it is shared with."
                                  },
                                  "quotedReminderRef": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The reminder's id."
                                          },
                                          "expectedVersion": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The reminder's version as last read."
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "expectedVersion"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The reminder's id and version as Werk's apps quote it in a chat message; null on a reminder shared by someone else."
                                  },
                                  "actions": {
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "enum": [
                                        "delete",
                                        "remove",
                                        "snooze_hour",
                                        "snooze_tomorrow",
                                        "invite_in_chat"
                                      ]
                                    },
                                    "description": "What the key's person may do with the reminder now: delete their own, remove a shared one from their list, snooze it, share it."
                                  }
                                },
                                "required": [
                                  "id",
                                  "itemId",
                                  "version",
                                  "timeRevision",
                                  "snoozeRevision",
                                  "fireAt",
                                  "effectiveFireAt",
                                  "snoozedUntil",
                                  "setterTimeZone",
                                  "text",
                                  "state",
                                  "audience",
                                  "quotedReminderRef",
                                  "actions"
                                ],
                                "additionalProperties": false,
                                "description": "The reminder, on a reminder's entry."
                              }
                            },
                            "required": [
                              "projectId",
                              "conversationId",
                              "item",
                              "day",
                              "overdue",
                              "kind",
                              "reminder"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project the entry is in."
                              },
                              "conversationId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                              },
                              "item": {
                                "type": "null",
                                "description": "The card, or null for a reminder with no card."
                              },
                              "day": {
                                "type": "string",
                                "format": "date",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                "description": "The day the entry falls on, in the key's person's time zone."
                              },
                              "overdue": {
                                "type": "boolean",
                                "description": "True when its time has passed."
                              },
                              "destination": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "card",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      },
                                      "itemId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The card's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId",
                                      "itemId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "chat",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      },
                                      "messageId": {
                                        "type": "string",
                                        "pattern": "^out:(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The chat message's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId",
                                      "messageId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "project",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "people",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      },
                                      "conversationId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                      },
                                      "projectId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The project's id."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "conversationId"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "cardless_reminders",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "plans",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "pulse",
                                        "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                      }
                                    },
                                    "required": [
                                      "kind"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "description": "Where Werk's apps open the entry."
                              },
                              "kind": {
                                "type": "string",
                                "const": "personal_reminder_cardless",
                                "description": "due for a card's due date, personal_reminder for a reminder on a card, personal_reminder_cardless for one with no card."
                              },
                              "reminder": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The reminder's id."
                                  },
                                  "itemId": {
                                    "type": "null",
                                    "description": "Always null: this reminder has no card."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                                  },
                                  "timeRevision": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                                  },
                                  "snoozeRevision": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                                  },
                                  "fireAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The time its owner set the reminder for."
                                  },
                                  "effectiveFireAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                                  },
                                  "snoozedUntil": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The time the key's person snoozed the reminder to, or null."
                                  },
                                  "setterTimeZone": {
                                    "type": "string",
                                    "description": "The time zone the reminder's time was set in."
                                  },
                                  "text": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The reminder's text, as its owner wrote it."
                                  },
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The language a shared reminder's text is written in."
                                  },
                                  "translation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A shared reminder's text in the reader's language, when it is written in another."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "upcoming",
                                      "past",
                                      "dropped"
                                    ],
                                    "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                                  },
                                  "audience": {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "const": "only_you",
                                        "description": "Always only_you: a reminder with no card is never shared."
                                      },
                                      "label": {
                                        "type": "string",
                                        "description": "Who the reminder is for, in one line in the reader's language."
                                      },
                                      "owner": {
                                        "type": "object",
                                        "properties": {
                                          "userId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person's id."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          }
                                        },
                                        "required": [
                                          "userId",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The person who set the reminder."
                                      },
                                      "invited": {
                                        "minItems": 0,
                                        "maxItems": 0,
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "userId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person's id."
                                            },
                                            "displayName": {
                                              "type": "string",
                                              "description": "The person's name as the project shows it."
                                            },
                                            "initials": {
                                              "type": "string",
                                              "description": "The person's initials, for an avatar with no photo."
                                            },
                                            "isViewer": {
                                              "type": "boolean",
                                              "description": "True when the person is the key's own person."
                                            },
                                            "photo": {
                                              "type": "object",
                                              "properties": {
                                                "personId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The person whose photo it is."
                                                },
                                                "version": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                }
                                              },
                                              "required": [
                                                "personId",
                                                "version"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The person's photo, when they have one."
                                            }
                                          },
                                          "required": [
                                            "userId",
                                            "displayName",
                                            "initials",
                                            "isViewer"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "description": "Always empty: a reminder with no card is never shared."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "label",
                                      "owner",
                                      "invited"
                                    ],
                                    "additionalProperties": false,
                                    "description": "Whose reminder it is and who it is shared with."
                                  },
                                  "quotedReminderRef": {
                                    "type": "null",
                                    "description": "Always null for a reminder with no card."
                                  },
                                  "actions": {
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "const": "delete"
                                    },
                                    "description": "What the key's person may do with the reminder now."
                                  }
                                },
                                "required": [
                                  "id",
                                  "itemId",
                                  "version",
                                  "timeRevision",
                                  "snoozeRevision",
                                  "fireAt",
                                  "effectiveFireAt",
                                  "snoozedUntil",
                                  "setterTimeZone",
                                  "text",
                                  "state",
                                  "audience",
                                  "quotedReminderRef",
                                  "actions"
                                ],
                                "additionalProperties": false,
                                "description": "The reminder, on a reminder's entry."
                              }
                            },
                            "required": [
                              "projectId",
                              "conversationId",
                              "item",
                              "day",
                              "overdue",
                              "kind",
                              "reminder"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      "description": "Due dates and reminders whose time has passed."
                    },
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "format": "date",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                            "description": "The day."
                          },
                          "entries": {
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "projectId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The project the entry is in."
                                    },
                                    "conversationId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                    },
                                    "item": {
                                      "type": "object",
                                      "properties": {
                                        "outcome": {
                                          "type": "string",
                                          "enum": [
                                            "open",
                                            "completed",
                                            "not_completed"
                                          ],
                                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                                        },
                                        "id": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The card's id."
                                        },
                                        "ref": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The card's number as people write it, with # before it."
                                        },
                                        "title": {
                                          "type": "string",
                                          "description": "The card's title, as written."
                                        },
                                        "language": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The language the card's title and description are written in."
                                        },
                                        "titleTranslation": {
                                          "type": "object",
                                          "properties": {
                                            "language": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The reader's language the text is translated into."
                                            },
                                            "state": {
                                              "type": "string",
                                              "enum": [
                                                "ready",
                                                "pending",
                                                "failed",
                                                "paused"
                                              ],
                                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "The translated text, present once ready."
                                            }
                                          },
                                          "required": [
                                            "language",
                                            "state"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The title in the reader's language, when it is written in another."
                                        },
                                        "status": {
                                          "type": "object",
                                          "properties": {
                                            "key": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The id of the step the card is on."
                                            },
                                            "label": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The step's name."
                                            },
                                            "category": {
                                              "type": "string",
                                              "enum": [
                                                "open",
                                                "active",
                                                "done"
                                              ],
                                              "description": "open on a new step, done on the project's last step, active on any other step."
                                            },
                                            "bucket": {
                                              "type": "string",
                                              "enum": [
                                                "new",
                                                "in_progress",
                                                "waiting",
                                                "resolved",
                                                "closed"
                                              ],
                                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                            },
                                            "labelLanguage": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                            },
                                            "labelTranslation": {
                                              "type": "object",
                                              "properties": {
                                                "language": {
                                                  "type": "string",
                                                  "minLength": 2,
                                                  "maxLength": 64,
                                                  "description": "The reader's language the text is translated into."
                                                },
                                                "state": {
                                                  "type": "string",
                                                  "enum": [
                                                    "ready",
                                                    "pending",
                                                    "failed",
                                                    "paused"
                                                  ],
                                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                                },
                                                "text": {
                                                  "type": "string",
                                                  "description": "The translated text, present once ready."
                                                }
                                              },
                                              "required": [
                                                "language",
                                                "state"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The step's name in the reader's language, when it is written in another."
                                            }
                                          },
                                          "required": [
                                            "key",
                                            "label",
                                            "category"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The step the card is on, with where that step sits in the work."
                                        },
                                        "dueNoticeLead": {
                                          "type": "string",
                                          "enum": [
                                            "none",
                                            "at_due",
                                            "15_minutes",
                                            "1_hour",
                                            "2_hours",
                                            "1_day",
                                            "2_days"
                                          ],
                                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                                        },
                                        "dueSetBy": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "displayName": {
                                                  "type": "string",
                                                  "description": "That person's name."
                                                }
                                              },
                                              "required": [
                                                "displayName"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "Who set the due moment; present only for a due date with a time."
                                        },
                                        "due": {
                                          "anyOf": [
                                            {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "date",
                                                      "description": "date for a due day with no time, datetime for a due moment."
                                                    },
                                                    "date": {
                                                      "type": "string",
                                                      "format": "date",
                                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                      "description": "The due day, as YYYY-MM-DD."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "date"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "datetime",
                                                      "description": "date for a due day with no time, datetime for a due moment."
                                                    },
                                                    "at": {
                                                      "type": "string",
                                                      "format": "date-time",
                                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                                    },
                                                    "enteredTimeZone": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ],
                                                      "description": "The time zone the due moment was given in, when known."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "at"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ]
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's due date, or null when it has none."
                                        },
                                        "assignee": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "personId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The holder's person id."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "description": "The holder's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The holder's initials, for an avatar with no photo."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The holder's photo, when they have one."
                                                }
                                              },
                                              "required": [
                                                "displayName"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's holder, or null when the card is free."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 9007199254740991,
                                          "description": "The card's version, which grows with every change to it."
                                        },
                                        "number": {
                                          "anyOf": [
                                            {
                                              "type": "integer",
                                              "minimum": 1,
                                              "maximum": 9007199254740991
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's number in its project, unique there and never reused."
                                        },
                                        "currentStep": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The step's id; a change of step sends it as stepId."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The step's name."
                                                },
                                                "bucket": {
                                                  "type": "string",
                                                  "enum": [
                                                    "new",
                                                    "in_progress",
                                                    "waiting",
                                                    "resolved",
                                                    "closed"
                                                  ],
                                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                                },
                                                "labelLanguage": {
                                                  "type": "string",
                                                  "minLength": 2,
                                                  "maxLength": 64,
                                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                                },
                                                "labelTranslation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "language": {
                                                      "type": "string",
                                                      "minLength": 2,
                                                      "maxLength": 64,
                                                      "description": "The reader's language the text is translated into."
                                                    },
                                                    "state": {
                                                      "type": "string",
                                                      "enum": [
                                                        "ready",
                                                        "pending",
                                                        "failed",
                                                        "paused"
                                                      ],
                                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                                    },
                                                    "text": {
                                                      "type": "string",
                                                      "description": "The translated text, present once ready."
                                                    }
                                                  },
                                                  "required": [
                                                    "language",
                                                    "state"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The step's name in the reader's language, when it is written in another."
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "label",
                                                "bucket"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's step among its project's steps, as the project defines it."
                                        },
                                        "archived": {
                                          "type": "boolean",
                                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                                        },
                                        "counts": {
                                          "type": "object",
                                          "properties": {
                                            "photos": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "Photos on the card."
                                            },
                                            "updates": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "Updates on the card."
                                            },
                                            "documents": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "Documents on the card."
                                            },
                                            "checklist": {
                                              "type": "object",
                                              "properties": {
                                                "done": {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "List items checked."
                                                },
                                                "total": {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "List items in all."
                                                }
                                              },
                                              "required": [
                                                "done",
                                                "total"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                                            }
                                          },
                                          "required": [
                                            "photos",
                                            "updates",
                                            "documents"
                                          ],
                                          "additionalProperties": false,
                                          "description": "How much the card holds."
                                        },
                                        "allowedActions": {
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "enum": [
                                              "take_card",
                                              "assign_card",
                                              "give_back_card",
                                              "move_card",
                                              "archive_card",
                                              "unarchive_card",
                                              "edit_card",
                                              "set_card_due",
                                              "add_update",
                                              "create_reminder",
                                              "link_duplicate",
                                              "add_entries",
                                              "rename_entry",
                                              "remove_entry",
                                              "reorder_entries",
                                              "follow_card",
                                              "unfollow_card",
                                              "follow_invitation",
                                              "tick_entry",
                                              "untick_entry",
                                              "set_due_notice"
                                            ]
                                          },
                                          "description": "The changes the key's person may make to this card by hand now, by action name."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "ref",
                                        "title",
                                        "status",
                                        "due",
                                        "assignee",
                                        "version"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The card, or null for a reminder with no card."
                                    },
                                    "day": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The day the entry falls on, in the key's person's time zone."
                                    },
                                    "overdue": {
                                      "type": "boolean",
                                      "description": "True when its time has passed."
                                    },
                                    "destination": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "card",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            },
                                            "itemId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The card's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId",
                                            "itemId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "chat",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            },
                                            "messageId": {
                                              "type": "string",
                                              "pattern": "^out:(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The chat message's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId",
                                            "messageId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "project",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "people",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "cardless_reminders",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "plans",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "pulse",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ],
                                      "description": "Where Werk's apps open the entry."
                                    },
                                    "kind": {
                                      "type": "string",
                                      "const": "due",
                                      "description": "due for a card's due date, personal_reminder for a reminder on a card, personal_reminder_cardless for one with no card."
                                    }
                                  },
                                  "required": [
                                    "projectId",
                                    "conversationId",
                                    "item",
                                    "day",
                                    "overdue",
                                    "kind"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "projectId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The project the entry is in."
                                    },
                                    "conversationId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                    },
                                    "item": {
                                      "type": "object",
                                      "properties": {
                                        "outcome": {
                                          "type": "string",
                                          "enum": [
                                            "open",
                                            "completed",
                                            "not_completed"
                                          ],
                                          "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                                        },
                                        "id": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The card's id."
                                        },
                                        "ref": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The card's number as people write it, with # before it."
                                        },
                                        "title": {
                                          "type": "string",
                                          "description": "The card's title, as written."
                                        },
                                        "language": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The language the card's title and description are written in."
                                        },
                                        "titleTranslation": {
                                          "type": "object",
                                          "properties": {
                                            "language": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The reader's language the text is translated into."
                                            },
                                            "state": {
                                              "type": "string",
                                              "enum": [
                                                "ready",
                                                "pending",
                                                "failed",
                                                "paused"
                                              ],
                                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "The translated text, present once ready."
                                            }
                                          },
                                          "required": [
                                            "language",
                                            "state"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The title in the reader's language, when it is written in another."
                                        },
                                        "status": {
                                          "type": "object",
                                          "properties": {
                                            "key": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The id of the step the card is on."
                                            },
                                            "label": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The step's name."
                                            },
                                            "category": {
                                              "type": "string",
                                              "enum": [
                                                "open",
                                                "active",
                                                "done"
                                              ],
                                              "description": "open on a new step, done on the project's last step, active on any other step."
                                            },
                                            "bucket": {
                                              "type": "string",
                                              "enum": [
                                                "new",
                                                "in_progress",
                                                "waiting",
                                                "resolved",
                                                "closed"
                                              ],
                                              "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                            },
                                            "labelLanguage": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                            },
                                            "labelTranslation": {
                                              "type": "object",
                                              "properties": {
                                                "language": {
                                                  "type": "string",
                                                  "minLength": 2,
                                                  "maxLength": 64,
                                                  "description": "The reader's language the text is translated into."
                                                },
                                                "state": {
                                                  "type": "string",
                                                  "enum": [
                                                    "ready",
                                                    "pending",
                                                    "failed",
                                                    "paused"
                                                  ],
                                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                                },
                                                "text": {
                                                  "type": "string",
                                                  "description": "The translated text, present once ready."
                                                }
                                              },
                                              "required": [
                                                "language",
                                                "state"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The step's name in the reader's language, when it is written in another."
                                            }
                                          },
                                          "required": [
                                            "key",
                                            "label",
                                            "category"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The step the card is on, with where that step sits in the work."
                                        },
                                        "dueNoticeLead": {
                                          "type": "string",
                                          "enum": [
                                            "none",
                                            "at_due",
                                            "15_minutes",
                                            "1_hour",
                                            "2_hours",
                                            "1_day",
                                            "2_days"
                                          ],
                                          "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                                        },
                                        "dueSetBy": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "displayName": {
                                                  "type": "string",
                                                  "description": "That person's name."
                                                }
                                              },
                                              "required": [
                                                "displayName"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "Who set the due moment; present only for a due date with a time."
                                        },
                                        "due": {
                                          "anyOf": [
                                            {
                                              "oneOf": [
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "date",
                                                      "description": "date for a due day with no time, datetime for a due moment."
                                                    },
                                                    "date": {
                                                      "type": "string",
                                                      "format": "date",
                                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                      "description": "The due day, as YYYY-MM-DD."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "date"
                                                  ],
                                                  "additionalProperties": false
                                                },
                                                {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "const": "datetime",
                                                      "description": "date for a due day with no time, datetime for a due moment."
                                                    },
                                                    "at": {
                                                      "type": "string",
                                                      "format": "date-time",
                                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                                      "description": "The due moment, as an ISO 8601 date and time with its offset."
                                                    },
                                                    "enteredTimeZone": {
                                                      "type": [
                                                        "string",
                                                        "null"
                                                      ],
                                                      "description": "The time zone the due moment was given in, when known."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "at"
                                                  ],
                                                  "additionalProperties": false
                                                }
                                              ]
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's due date, or null when it has none."
                                        },
                                        "assignee": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "personId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The holder's person id."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "description": "The holder's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The holder's initials, for an avatar with no photo."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The holder's photo, when they have one."
                                                }
                                              },
                                              "required": [
                                                "displayName"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's holder, or null when the card is free."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 9007199254740991,
                                          "description": "The card's version, which grows with every change to it."
                                        },
                                        "number": {
                                          "anyOf": [
                                            {
                                              "type": "integer",
                                              "minimum": 1,
                                              "maximum": 9007199254740991
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's number in its project, unique there and never reused."
                                        },
                                        "currentStep": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The step's id; a change of step sends it as stepId."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The step's name."
                                                },
                                                "bucket": {
                                                  "type": "string",
                                                  "enum": [
                                                    "new",
                                                    "in_progress",
                                                    "waiting",
                                                    "resolved",
                                                    "closed"
                                                  ],
                                                  "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                                },
                                                "labelLanguage": {
                                                  "type": "string",
                                                  "minLength": 2,
                                                  "maxLength": 64,
                                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                                },
                                                "labelTranslation": {
                                                  "type": "object",
                                                  "properties": {
                                                    "language": {
                                                      "type": "string",
                                                      "minLength": 2,
                                                      "maxLength": 64,
                                                      "description": "The reader's language the text is translated into."
                                                    },
                                                    "state": {
                                                      "type": "string",
                                                      "enum": [
                                                        "ready",
                                                        "pending",
                                                        "failed",
                                                        "paused"
                                                      ],
                                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                                    },
                                                    "text": {
                                                      "type": "string",
                                                      "description": "The translated text, present once ready."
                                                    }
                                                  },
                                                  "required": [
                                                    "language",
                                                    "state"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The step's name in the reader's language, when it is written in another."
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "label",
                                                "bucket"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The card's step among its project's steps, as the project defines it."
                                        },
                                        "archived": {
                                          "type": "boolean",
                                          "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                                        },
                                        "counts": {
                                          "type": "object",
                                          "properties": {
                                            "photos": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "Photos on the card."
                                            },
                                            "updates": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "Updates on the card."
                                            },
                                            "documents": {
                                              "type": "integer",
                                              "minimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "Documents on the card."
                                            },
                                            "checklist": {
                                              "type": "object",
                                              "properties": {
                                                "done": {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "List items checked."
                                                },
                                                "total": {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "List items in all."
                                                }
                                              },
                                              "required": [
                                                "done",
                                                "total"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The card's list: its items checked and in all; absent when the card has no list."
                                            }
                                          },
                                          "required": [
                                            "photos",
                                            "updates",
                                            "documents"
                                          ],
                                          "additionalProperties": false,
                                          "description": "How much the card holds."
                                        },
                                        "allowedActions": {
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "enum": [
                                              "take_card",
                                              "assign_card",
                                              "give_back_card",
                                              "move_card",
                                              "archive_card",
                                              "unarchive_card",
                                              "edit_card",
                                              "set_card_due",
                                              "add_update",
                                              "create_reminder",
                                              "link_duplicate",
                                              "add_entries",
                                              "rename_entry",
                                              "remove_entry",
                                              "reorder_entries",
                                              "follow_card",
                                              "unfollow_card",
                                              "follow_invitation",
                                              "tick_entry",
                                              "untick_entry",
                                              "set_due_notice"
                                            ]
                                          },
                                          "description": "The changes the key's person may make to this card by hand now, by action name."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "ref",
                                        "title",
                                        "status",
                                        "due",
                                        "assignee",
                                        "version"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The card, or null for a reminder with no card."
                                    },
                                    "day": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The day the entry falls on, in the key's person's time zone."
                                    },
                                    "overdue": {
                                      "type": "boolean",
                                      "description": "True when its time has passed."
                                    },
                                    "destination": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "card",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            },
                                            "itemId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The card's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId",
                                            "itemId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "chat",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            },
                                            "messageId": {
                                              "type": "string",
                                              "pattern": "^out:(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The chat message's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId",
                                            "messageId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "project",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "people",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "cardless_reminders",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "plans",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "pulse",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ],
                                      "description": "Where Werk's apps open the entry."
                                    },
                                    "kind": {
                                      "type": "string",
                                      "const": "personal_reminder",
                                      "description": "due for a card's due date, personal_reminder for a reminder on a card, personal_reminder_cardless for one with no card."
                                    },
                                    "reminder": {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The reminder's id."
                                        },
                                        "itemId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The card the reminder is on."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                                        },
                                        "timeRevision": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                                        },
                                        "snoozeRevision": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                                        },
                                        "fireAt": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The time its owner set the reminder for."
                                        },
                                        "effectiveFireAt": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                                        },
                                        "snoozedUntil": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The time the key's person snoozed the reminder to, or null."
                                        },
                                        "setterTimeZone": {
                                          "type": "string",
                                          "description": "The time zone the reminder's time was set in."
                                        },
                                        "text": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The reminder's text, as its owner wrote it."
                                        },
                                        "language": {
                                          "type": "string",
                                          "minLength": 2,
                                          "maxLength": 64,
                                          "description": "The language a shared reminder's text is written in."
                                        },
                                        "translation": {
                                          "type": "object",
                                          "properties": {
                                            "language": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The reader's language the text is translated into."
                                            },
                                            "state": {
                                              "type": "string",
                                              "enum": [
                                                "ready",
                                                "pending",
                                                "failed",
                                                "paused"
                                              ],
                                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "The translated text, present once ready."
                                            }
                                          },
                                          "required": [
                                            "language",
                                            "state"
                                          ],
                                          "additionalProperties": false,
                                          "description": "A shared reminder's text in the reader's language, when it is written in another."
                                        },
                                        "state": {
                                          "type": "string",
                                          "enum": [
                                            "upcoming",
                                            "past",
                                            "dropped"
                                          ],
                                          "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                                        },
                                        "audience": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "only_you",
                                                "invited_by_you",
                                                "from_owner"
                                              ],
                                              "description": "only_you for the key's person's own reminder shared with nobody, invited_by_you for their own reminder shared with others, from_owner for a reminder someone shared with them."
                                            },
                                            "label": {
                                              "type": "string",
                                              "description": "Who the reminder is for, in one line in the reader's language."
                                            },
                                            "owner": {
                                              "type": "object",
                                              "properties": {
                                                "userId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The person's id."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "description": "The person's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The person's initials, for an avatar with no photo."
                                                },
                                                "isViewer": {
                                                  "type": "boolean",
                                                  "description": "True when the person is the key's own person."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The person's photo, when they have one."
                                                }
                                              },
                                              "required": [
                                                "userId",
                                                "displayName",
                                                "initials",
                                                "isViewer"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The person who set the reminder."
                                            },
                                            "invited": {
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "userId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person's id."
                                                  },
                                                  "displayName": {
                                                    "type": "string",
                                                    "description": "The person's name as the project shows it."
                                                  },
                                                  "initials": {
                                                    "type": "string",
                                                    "description": "The person's initials, for an avatar with no photo."
                                                  },
                                                  "isViewer": {
                                                    "type": "boolean",
                                                    "description": "True when the person is the key's own person."
                                                  },
                                                  "photo": {
                                                    "type": "object",
                                                    "properties": {
                                                      "personId": {
                                                        "type": "string",
                                                        "format": "uuid",
                                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                        "description": "The person whose photo it is."
                                                      },
                                                      "version": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                      }
                                                    },
                                                    "required": [
                                                      "personId",
                                                      "version"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The person's photo, when they have one."
                                                  }
                                                },
                                                "required": [
                                                  "userId",
                                                  "displayName",
                                                  "initials",
                                                  "isViewer"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "description": "The people the owner shared the reminder with who accepted it."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "label",
                                            "owner",
                                            "invited"
                                          ],
                                          "additionalProperties": false,
                                          "description": "Whose reminder it is and who it is shared with."
                                        },
                                        "quotedReminderRef": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "id": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The reminder's id."
                                                },
                                                "expectedVersion": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The reminder's version as last read."
                                                }
                                              },
                                              "required": [
                                                "id",
                                                "expectedVersion"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The reminder's id and version as Werk's apps quote it in a chat message; null on a reminder shared by someone else."
                                        },
                                        "actions": {
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "enum": [
                                              "delete",
                                              "remove",
                                              "snooze_hour",
                                              "snooze_tomorrow",
                                              "invite_in_chat"
                                            ]
                                          },
                                          "description": "What the key's person may do with the reminder now: delete their own, remove a shared one from their list, snooze it, share it."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "itemId",
                                        "version",
                                        "timeRevision",
                                        "snoozeRevision",
                                        "fireAt",
                                        "effectiveFireAt",
                                        "snoozedUntil",
                                        "setterTimeZone",
                                        "text",
                                        "state",
                                        "audience",
                                        "quotedReminderRef",
                                        "actions"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The reminder, on a reminder's entry."
                                    }
                                  },
                                  "required": [
                                    "projectId",
                                    "conversationId",
                                    "item",
                                    "day",
                                    "overdue",
                                    "kind",
                                    "reminder"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "projectId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The project the entry is in."
                                    },
                                    "conversationId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                    },
                                    "item": {
                                      "type": "null",
                                      "description": "The card, or null for a reminder with no card."
                                    },
                                    "day": {
                                      "type": "string",
                                      "format": "date",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                      "description": "The day the entry falls on, in the key's person's time zone."
                                    },
                                    "overdue": {
                                      "type": "boolean",
                                      "description": "True when its time has passed."
                                    },
                                    "destination": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "card",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            },
                                            "itemId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The card's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId",
                                            "itemId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "chat",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            },
                                            "messageId": {
                                              "type": "string",
                                              "pattern": "^out:(?:[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The chat message's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId",
                                            "messageId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "project",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "people",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            },
                                            "conversationId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                                            },
                                            "projectId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The project's id."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "conversationId"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "cardless_reminders",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "plans",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "pulse",
                                              "description": "What the apps open: a card, a chat message, a project, its people, the reminders with no card, the plans or Pulse."
                                            }
                                          },
                                          "required": [
                                            "kind"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ],
                                      "description": "Where Werk's apps open the entry."
                                    },
                                    "kind": {
                                      "type": "string",
                                      "const": "personal_reminder_cardless",
                                      "description": "due for a card's due date, personal_reminder for a reminder on a card, personal_reminder_cardless for one with no card."
                                    },
                                    "reminder": {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The reminder's id."
                                        },
                                        "itemId": {
                                          "type": "null",
                                          "description": "Always null: this reminder has no card."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                                        },
                                        "timeRevision": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                                        },
                                        "snoozeRevision": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                                        },
                                        "fireAt": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The time its owner set the reminder for."
                                        },
                                        "effectiveFireAt": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                                        },
                                        "snoozedUntil": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "format": "date-time",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The time the key's person snoozed the reminder to, or null."
                                        },
                                        "setterTimeZone": {
                                          "type": "string",
                                          "description": "The time zone the reminder's time was set in."
                                        },
                                        "text": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The reminder's text, as its owner wrote it."
                                        },
                                        "language": {
                                          "type": "string",
                                          "minLength": 2,
                                          "maxLength": 64,
                                          "description": "The language a shared reminder's text is written in."
                                        },
                                        "translation": {
                                          "type": "object",
                                          "properties": {
                                            "language": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The reader's language the text is translated into."
                                            },
                                            "state": {
                                              "type": "string",
                                              "enum": [
                                                "ready",
                                                "pending",
                                                "failed",
                                                "paused"
                                              ],
                                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "The translated text, present once ready."
                                            }
                                          },
                                          "required": [
                                            "language",
                                            "state"
                                          ],
                                          "additionalProperties": false,
                                          "description": "A shared reminder's text in the reader's language, when it is written in another."
                                        },
                                        "state": {
                                          "type": "string",
                                          "enum": [
                                            "upcoming",
                                            "past",
                                            "dropped"
                                          ],
                                          "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                                        },
                                        "audience": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "only_you",
                                              "description": "Always only_you: a reminder with no card is never shared."
                                            },
                                            "label": {
                                              "type": "string",
                                              "description": "Who the reminder is for, in one line in the reader's language."
                                            },
                                            "owner": {
                                              "type": "object",
                                              "properties": {
                                                "userId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The person's id."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "description": "The person's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The person's initials, for an avatar with no photo."
                                                },
                                                "isViewer": {
                                                  "type": "boolean",
                                                  "description": "True when the person is the key's own person."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The person's photo, when they have one."
                                                }
                                              },
                                              "required": [
                                                "userId",
                                                "displayName",
                                                "initials",
                                                "isViewer"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The person who set the reminder."
                                            },
                                            "invited": {
                                              "minItems": 0,
                                              "maxItems": 0,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "userId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person's id."
                                                  },
                                                  "displayName": {
                                                    "type": "string",
                                                    "description": "The person's name as the project shows it."
                                                  },
                                                  "initials": {
                                                    "type": "string",
                                                    "description": "The person's initials, for an avatar with no photo."
                                                  },
                                                  "isViewer": {
                                                    "type": "boolean",
                                                    "description": "True when the person is the key's own person."
                                                  },
                                                  "photo": {
                                                    "type": "object",
                                                    "properties": {
                                                      "personId": {
                                                        "type": "string",
                                                        "format": "uuid",
                                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                        "description": "The person whose photo it is."
                                                      },
                                                      "version": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                      }
                                                    },
                                                    "required": [
                                                      "personId",
                                                      "version"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The person's photo, when they have one."
                                                  }
                                                },
                                                "required": [
                                                  "userId",
                                                  "displayName",
                                                  "initials",
                                                  "isViewer"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "description": "Always empty: a reminder with no card is never shared."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "label",
                                            "owner",
                                            "invited"
                                          ],
                                          "additionalProperties": false,
                                          "description": "Whose reminder it is and who it is shared with."
                                        },
                                        "quotedReminderRef": {
                                          "type": "null",
                                          "description": "Always null for a reminder with no card."
                                        },
                                        "actions": {
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "const": "delete"
                                          },
                                          "description": "What the key's person may do with the reminder now."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "itemId",
                                        "version",
                                        "timeRevision",
                                        "snoozeRevision",
                                        "fireAt",
                                        "effectiveFireAt",
                                        "snoozedUntil",
                                        "setterTimeZone",
                                        "text",
                                        "state",
                                        "audience",
                                        "quotedReminderRef",
                                        "actions"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The reminder, on a reminder's entry."
                                    }
                                  },
                                  "required": [
                                    "projectId",
                                    "conversationId",
                                    "item",
                                    "day",
                                    "overdue",
                                    "kind",
                                    "reminder"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "description": "What falls on that day: due dates first, then reminders by time."
                          }
                        },
                        "required": [
                          "day",
                          "entries"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Each day with something on it, in order."
                    }
                  },
                  "required": [
                    "nextCursor",
                    "hasMore",
                    "timeZone",
                    "today",
                    "through",
                    "overdue",
                    "days"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "nextCursor": null,
                  "hasMore": false,
                  "timeZone": "America/New_York",
                  "today": "2026-11-21",
                  "through": "2026-12-04",
                  "overdue": [],
                  "days": [
                    {
                      "day": "2026-11-24",
                      "entries": [
                        {
                          "kind": "personal_reminder",
                          "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                          "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                          "item": {
                            "outcome": "open",
                            "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                            "ref": "#14",
                            "title": "Order the quartz countertop",
                            "language": "en-US",
                            "status": {
                              "key": "in_progress",
                              "label": "In progress",
                              "category": "active",
                              "bucket": "in_progress"
                            },
                            "dueNoticeLead": "at_due",
                            "due": {
                              "kind": "datetime",
                              "at": "2026-11-25T20:00:00.000Z",
                              "enteredTimeZone": "America/New_York"
                            },
                            "dueSetBy": {
                              "displayName": "Maya Chen"
                            },
                            "assignee": {
                              "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                              "displayName": "Maya Chen",
                              "initials": "MC"
                            },
                            "version": 7,
                            "number": 14,
                            "currentStep": {
                              "id": "in_progress",
                              "label": "In progress",
                              "bucket": "in_progress"
                            },
                            "archived": false,
                            "counts": {
                              "photos": 0,
                              "updates": 0,
                              "documents": 1
                            }
                          },
                          "day": "2026-11-24",
                          "overdue": false,
                          "reminder": {
                            "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                            "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                            "version": 1,
                            "timeRevision": 1,
                            "snoozeRevision": 0,
                            "fireAt": "2026-11-24T13:00:00.000Z",
                            "effectiveFireAt": "2026-11-24T13:00:00.000Z",
                            "snoozedUntil": null,
                            "setterTimeZone": "America/New_York",
                            "text": "Call the supplier about delivery",
                            "state": "upcoming",
                            "audience": {
                              "kind": "only_you",
                              "label": "Only you",
                              "owner": {
                                "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                                "displayName": "Maya Chen",
                                "initials": "MC",
                                "isViewer": true
                              },
                              "invited": []
                            },
                            "quotedReminderRef": {
                              "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                              "expectedVersion": 1
                            },
                            "actions": [
                              "delete",
                              "snooze_hour",
                              "snooze_tomorrow",
                              "invite_in_chat"
                            ]
                          }
                        }
                      ]
                    },
                    {
                      "day": "2026-11-25",
                      "entries": [
                        {
                          "kind": "due",
                          "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                          "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                          "item": {
                            "outcome": "open",
                            "id": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                            "ref": "#14",
                            "title": "Order the quartz countertop",
                            "language": "en-US",
                            "status": {
                              "key": "in_progress",
                              "label": "In progress",
                              "category": "active",
                              "bucket": "in_progress"
                            },
                            "dueNoticeLead": "at_due",
                            "due": {
                              "kind": "datetime",
                              "at": "2026-11-25T20:00:00.000Z",
                              "enteredTimeZone": "America/New_York"
                            },
                            "dueSetBy": {
                              "displayName": "Maya Chen"
                            },
                            "assignee": {
                              "personId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                              "displayName": "Maya Chen",
                              "initials": "MC"
                            },
                            "version": 7,
                            "number": 14,
                            "currentStep": {
                              "id": "in_progress",
                              "label": "In progress",
                              "bucket": "in_progress"
                            },
                            "archived": false,
                            "counts": {
                              "photos": 0,
                              "updates": 0,
                              "documents": 1
                            }
                          },
                          "day": "2026-11-25",
                          "overdue": false
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_limit",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/invitations": {
      "get": {
        "operationId": "GET /api/v1/account/invitations",
        "tags": [
          "cards"
        ],
        "summary": "List my invitations",
        "description": "The invitations waiting for the key's person's answer across their projects: to follow a card, and to take a shared reminder.\n\nNewest first. A shared reminder's text is read once it is accepted.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many invitations a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "20"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The invitations.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "invitations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "follow",
                              "reminder"
                            ],
                            "description": "follow for an invitation to follow a card, reminder for a reminder shared with the key's person."
                          },
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The invitation's id."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The invitation's version; the answer sends it as expectedVersion."
                          },
                          "expiresAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the invitation lapses if not answered."
                          },
                          "projectId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The project the card is in."
                          },
                          "projectName": {
                            "type": "string",
                            "description": "The project's name."
                          },
                          "item": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "number": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's number."
                              },
                              "title": {
                                "type": "string",
                                "description": "The card's title."
                              }
                            },
                            "required": [
                              "id",
                              "number",
                              "title"
                            ],
                            "additionalProperties": false,
                            "description": "The card the invitation is about."
                          },
                          "inviter": {
                            "type": "object",
                            "properties": {
                              "userId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "displayName": {
                                "type": "string",
                                "description": "The person's name."
                              }
                            },
                            "required": [
                              "userId",
                              "displayName"
                            ],
                            "additionalProperties": false,
                            "description": "Who sent the invitation."
                          },
                          "fireAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "For a shared reminder, the time it is set for."
                          }
                        },
                        "required": [
                          "kind",
                          "id",
                          "version",
                          "expiresAt",
                          "projectId",
                          "projectName",
                          "item",
                          "inviter"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The invitations waiting for the key's person's answer, newest first."
                    },
                    "nextCursor": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "invitations",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "invitations": [
                    {
                      "kind": "reminder",
                      "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                      "version": 1,
                      "expiresAt": "2026-11-24T13:00:00.000Z",
                      "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                      "projectName": "Harbor Street kitchen",
                      "item": {
                        "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "number": 12,
                        "title": "Replace the leaking sink faucet"
                      },
                      "inviter": {
                        "userId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "displayName": "Tom Okafor"
                      },
                      "fireAt": "2026-11-24T13:00:00.000Z"
                    }
                  ],
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_limit"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/cards": {
      "get": {
        "operationId": "GET /api/v1/cards",
        "tags": [
          "cards"
        ],
        "summary": "Search cards",
        "description": "The key's person's cards across their projects, listed by filters or searched by words.\n\nWith q, Werk looks in the cards' titles, descriptions, updates, lists, photos, voice notes and documents, by words and by meaning, best match first. Without q, the cards the filters keep are listed in the order sort and order give, each with its own default.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "The words to look for; left out, cards are listed by the other filters.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "example": "faucet"
          },
          {
            "name": "in",
            "in": "query",
            "required": false,
            "description": "Where to look for the words, comma separated: title, description, card, update, list, photo, voice_note, document; left out, everywhere.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "projects",
            "in": "query",
            "required": false,
            "description": "Project ids, comma separated; left out, every project of the key's person.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "description": "open, done, archived or all; left out, all with q or a span of when cards were made, changed or done, and open otherwise.",
            "schema": {
              "type": "string",
              "enum": [
                "open",
                "done",
                "archived",
                "all"
              ]
            }
          },
          {
            "name": "holder",
            "in": "query",
            "required": false,
            "description": "A person's id to keep the cards they hold, or none for free cards.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "const": "none"
                },
                {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                }
              ]
            }
          },
          {
            "name": "author",
            "in": "query",
            "required": false,
            "description": "A person's id, to keep the cards they created.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            }
          },
          {
            "name": "following",
            "in": "query",
            "required": false,
            "description": "true keeps the cards the key's person follows.",
            "schema": {
              "type": "string",
              "const": "true"
            }
          },
          {
            "name": "step",
            "in": "query",
            "required": false,
            "description": "A step's id, to keep the cards on it; only with exactly one project in projects.",
            "schema": {
              "type": "string",
              "maxLength": 64,
              "pattern": "^[a-z][a-z0-9_]*$"
            }
          },
          {
            "name": "due",
            "in": "query",
            "required": false,
            "description": "none keeps the cards with no due date; it cannot go with dueFrom or dueBefore.",
            "schema": {
              "type": "string",
              "const": "none"
            }
          },
          {
            "name": "dueFrom",
            "in": "query",
            "required": false,
            "description": "Keeps cards due from this day or moment on: YYYY-MM-DD in the key's person's time zone, or an ISO 8601 date and time with Z or an offset.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "dueBefore",
            "in": "query",
            "required": false,
            "description": "Keeps cards due before this day or moment, in the same forms as dueFrom.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "createdFrom",
            "in": "query",
            "required": false,
            "description": "Keeps cards created from this day or moment on, in the same forms as dueFrom.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "createdBefore",
            "in": "query",
            "required": false,
            "description": "Keeps cards created before this day or moment.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "updatedFrom",
            "in": "query",
            "required": false,
            "description": "Keeps cards changed from this day or moment on.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "updatedBefore",
            "in": "query",
            "required": false,
            "description": "Keeps cards changed before this day or moment.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "doneFrom",
            "in": "query",
            "required": false,
            "description": "Keeps cards that reached their last step from this day or moment on.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "doneBefore",
            "in": "query",
            "required": false,
            "description": "Keeps cards that reached their last step before this day or moment.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "relevance, only with q; board, the project's own order, with exactly one project and a state other than all; updated, created, due or number. Left out, relevance with q, board for one project, updated otherwise.",
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "board",
                "updated",
                "created",
                "due",
                "number"
              ]
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "The order of the sort; left out, each sort's own: oldest first for board, due and number, newest first for the rest.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many cards a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The cards found.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "project": {
                            "type": "object",
                            "properties": {
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project's id."
                              },
                              "conversationId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id Werk's apps use for the key's person's view of the project."
                              },
                              "name": {
                                "type": "string",
                                "description": "The project's name."
                              },
                              "finalStep": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "description": "The step's id."
                                  },
                                  "label": {
                                    "type": "string",
                                    "description": "The step's name."
                                  }
                                },
                                "required": [
                                  "id",
                                  "label"
                                ],
                                "additionalProperties": false,
                                "description": "The project's last step, the one that ends the work."
                              }
                            },
                            "required": [
                              "projectId",
                              "conversationId",
                              "name",
                              "finalStep"
                            ],
                            "additionalProperties": false,
                            "description": "The card's project."
                          },
                          "item": {
                            "type": "object",
                            "properties": {
                              "outcome": {
                                "type": "string",
                                "enum": [
                                  "open",
                                  "completed",
                                  "not_completed"
                                ],
                                "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                              },
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "ref": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The card's number as people write it, with # before it."
                              },
                              "title": {
                                "type": "string",
                                "description": "The card's title, as written."
                              },
                              "language": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The language the card's title and description are written in."
                              },
                              "titleTranslation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The title in the reader's language, when it is written in another."
                              },
                              "status": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The id of the step the card is on."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The step's name."
                                  },
                                  "category": {
                                    "type": "string",
                                    "enum": [
                                      "open",
                                      "active",
                                      "done"
                                    ],
                                    "description": "open on a new step, done on the project's last step, active on any other step."
                                  },
                                  "bucket": {
                                    "type": "string",
                                    "enum": [
                                      "new",
                                      "in_progress",
                                      "waiting",
                                      "resolved",
                                      "closed"
                                    ],
                                    "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                  },
                                  "labelLanguage": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                  },
                                  "labelTranslation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The step's name in the reader's language, when it is written in another."
                                  }
                                },
                                "required": [
                                  "key",
                                  "label",
                                  "category"
                                ],
                                "additionalProperties": false,
                                "description": "The step the card is on, with where that step sits in the work."
                              },
                              "dueNoticeLead": {
                                "type": "string",
                                "enum": [
                                  "none",
                                  "at_due",
                                  "15_minutes",
                                  "1_hour",
                                  "2_hours",
                                  "1_day",
                                  "2_days"
                                ],
                                "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                              },
                              "dueSetBy": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "displayName": {
                                        "type": "string",
                                        "description": "That person's name."
                                      }
                                    },
                                    "required": [
                                      "displayName"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who set the due moment; present only for a due date with a time."
                              },
                              "due": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "date",
                                            "description": "date for a due day with no time, datetime for a due moment."
                                          },
                                          "date": {
                                            "type": "string",
                                            "format": "date",
                                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                            "description": "The due day, as YYYY-MM-DD."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "date"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "datetime",
                                            "description": "date for a due day with no time, datetime for a due moment."
                                          },
                                          "at": {
                                            "type": "string",
                                            "format": "date-time",
                                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                            "description": "The due moment, as an ISO 8601 date and time with its offset."
                                          },
                                          "enteredTimeZone": {
                                            "type": [
                                              "string",
                                              "null"
                                            ],
                                            "description": "The time zone the due moment was given in, when known."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "at"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's due date, or null when it has none."
                              },
                              "assignee": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "personId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The holder's person id."
                                      },
                                      "displayName": {
                                        "type": "string",
                                        "description": "The holder's name as the project shows it."
                                      },
                                      "initials": {
                                        "type": "string",
                                        "description": "The holder's initials, for an avatar with no photo."
                                      },
                                      "photo": {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person whose photo it is."
                                          },
                                          "version": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                          }
                                        },
                                        "required": [
                                          "personId",
                                          "version"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The holder's photo, when they have one."
                                      }
                                    },
                                    "required": [
                                      "displayName"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's holder, or null when the card is free."
                              },
                              "version": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9007199254740991,
                                "description": "The card's version, which grows with every change to it."
                              },
                              "number": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's number in its project, unique there and never reused."
                              },
                              "currentStep": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The step's id; a change of step sends it as stepId."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The step's name."
                                      },
                                      "bucket": {
                                        "type": "string",
                                        "enum": [
                                          "new",
                                          "in_progress",
                                          "waiting",
                                          "resolved",
                                          "closed"
                                        ],
                                        "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                      },
                                      "labelLanguage": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                      },
                                      "labelTranslation": {
                                        "type": "object",
                                        "properties": {
                                          "language": {
                                            "type": "string",
                                            "minLength": 2,
                                            "maxLength": 64,
                                            "description": "The reader's language the text is translated into."
                                          },
                                          "state": {
                                            "type": "string",
                                            "enum": [
                                              "ready",
                                              "pending",
                                              "failed",
                                              "paused"
                                            ],
                                            "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                          },
                                          "text": {
                                            "type": "string",
                                            "description": "The translated text, present once ready."
                                          }
                                        },
                                        "required": [
                                          "language",
                                          "state"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The step's name in the reader's language, when it is written in another."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "label",
                                      "bucket"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's step among its project's steps, as the project defines it."
                              },
                              "archived": {
                                "type": "boolean",
                                "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                              },
                              "counts": {
                                "type": "object",
                                "properties": {
                                  "photos": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Photos on the card."
                                  },
                                  "updates": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Updates on the card."
                                  },
                                  "documents": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Documents on the card."
                                  },
                                  "checklist": {
                                    "type": "object",
                                    "properties": {
                                      "done": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "List items checked."
                                      },
                                      "total": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "List items in all."
                                      }
                                    },
                                    "required": [
                                      "done",
                                      "total"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The card's list: its items checked and in all; absent when the card has no list."
                                  }
                                },
                                "required": [
                                  "photos",
                                  "updates",
                                  "documents"
                                ],
                                "additionalProperties": false,
                                "description": "How much the card holds."
                              },
                              "allowedActions": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "take_card",
                                    "assign_card",
                                    "give_back_card",
                                    "move_card",
                                    "archive_card",
                                    "unarchive_card",
                                    "edit_card",
                                    "set_card_due",
                                    "add_update",
                                    "create_reminder",
                                    "link_duplicate",
                                    "add_entries",
                                    "rename_entry",
                                    "remove_entry",
                                    "reorder_entries",
                                    "follow_card",
                                    "unfollow_card",
                                    "follow_invitation",
                                    "tick_entry",
                                    "untick_entry",
                                    "set_due_notice"
                                  ]
                                },
                                "description": "The changes the key's person may make to this card by hand now, by action name."
                              }
                            },
                            "required": [
                              "id",
                              "ref",
                              "title",
                              "status",
                              "due",
                              "assignee",
                              "version"
                            ],
                            "additionalProperties": false,
                            "description": "The card."
                          },
                          "foundBy": {
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "words",
                                "meaning"
                              ]
                            },
                            "description": "With words, how the card was found: by its words, by meaning, or both; empty without words."
                          },
                          "matches": {
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "const": "title",
                                      "description": "Where it matched: the title, the description, the card's text by meaning, an update, a list item, a photo, a voice note or a document."
                                    }
                                  },
                                  "required": [
                                    "in"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "const": "card",
                                      "description": "Where it matched: the title, the description, the card's text by meaning, an update, a list item, a photo, a voice note or a document."
                                    }
                                  },
                                  "required": [
                                    "in"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "const": "description",
                                      "description": "Where it matched: the title, the description, the card's text by meaning, an update, a list item, a photo, a voice note or a document."
                                    },
                                    "text": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The piece of text that matched, or null when none is quoted."
                                    }
                                  },
                                  "required": [
                                    "in",
                                    "text"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "enum": [
                                        "update",
                                        "photo",
                                        "voice_note"
                                      ],
                                      "description": "Where it matched: the title, the description, the card's text by meaning, an update, a list item, a photo, a voice note or a document."
                                    },
                                    "text": {
                                      "type": [
                                        "string",
                                        "null"
                                      ],
                                      "description": "The piece of text that matched, or null when none is quoted."
                                    },
                                    "by": {
                                      "anyOf": [
                                        {
                                          "oneOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "user",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The person's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The person's initials, for an avatar with no photo."
                                                },
                                                "isViewer": {
                                                  "type": "boolean",
                                                  "description": "True when the person is the key's own person."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The person's photo, when they have one."
                                                },
                                                "via": {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "enum": [
                                                        "connection",
                                                        "key"
                                                      ],
                                                      "description": "connection for an app connected by sign-in, key for an API key."
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The app's or the key's name, as Werk shows it."
                                                    },
                                                    "verified": {
                                                      "type": "boolean",
                                                      "description": "True when Werk verified the app's identity."
                                                    },
                                                    "label": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The caption Werk shows beside the change, in the reader's language."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "name",
                                                    "verified",
                                                    "label"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "displayName",
                                                "initials",
                                                "isViewer"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "connector",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The name Werk shows for a change made without a person."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "label"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "schedule",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The name Werk shows for a change made without a person."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "label"
                                              ],
                                              "additionalProperties": false
                                            }
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "Who added what matched, or null when no longer known."
                                    },
                                    "at": {
                                      "type": "string",
                                      "description": "When what matched was added."
                                    }
                                  },
                                  "required": [
                                    "in",
                                    "text",
                                    "by",
                                    "at"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "const": "list",
                                      "description": "Where it matched: the title, the description, the card's text by meaning, an update, a list item, a photo, a voice note or a document."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The piece of text that matched, or null when none is quoted."
                                    },
                                    "by": {
                                      "anyOf": [
                                        {
                                          "oneOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "user",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The person's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The person's initials, for an avatar with no photo."
                                                },
                                                "isViewer": {
                                                  "type": "boolean",
                                                  "description": "True when the person is the key's own person."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The person's photo, when they have one."
                                                },
                                                "via": {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "enum": [
                                                        "connection",
                                                        "key"
                                                      ],
                                                      "description": "connection for an app connected by sign-in, key for an API key."
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The app's or the key's name, as Werk shows it."
                                                    },
                                                    "verified": {
                                                      "type": "boolean",
                                                      "description": "True when Werk verified the app's identity."
                                                    },
                                                    "label": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The caption Werk shows beside the change, in the reader's language."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "name",
                                                    "verified",
                                                    "label"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "displayName",
                                                "initials",
                                                "isViewer"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "connector",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The name Werk shows for a change made without a person."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "label"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "schedule",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The name Werk shows for a change made without a person."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "label"
                                              ],
                                              "additionalProperties": false
                                            }
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "Who added what matched, or null when no longer known."
                                    },
                                    "at": {
                                      "type": "string",
                                      "description": "When what matched was added."
                                    },
                                    "checked": {
                                      "type": "boolean",
                                      "description": "For a list item, true when it is checked."
                                    }
                                  },
                                  "required": [
                                    "in",
                                    "text",
                                    "by",
                                    "at",
                                    "checked"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "const": "document",
                                      "description": "Where it matched: the title, the description, the card's text by meaning, an update, a list item, a photo, a voice note or a document."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The piece of text that matched, or null when none is quoted."
                                    },
                                    "by": {
                                      "anyOf": [
                                        {
                                          "oneOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "user",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "displayName": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The person's name as the project shows it."
                                                },
                                                "initials": {
                                                  "type": "string",
                                                  "description": "The person's initials, for an avatar with no photo."
                                                },
                                                "isViewer": {
                                                  "type": "boolean",
                                                  "description": "True when the person is the key's own person."
                                                },
                                                "photo": {
                                                  "type": "object",
                                                  "properties": {
                                                    "personId": {
                                                      "type": "string",
                                                      "format": "uuid",
                                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                      "description": "The person whose photo it is."
                                                    },
                                                    "version": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                    }
                                                  },
                                                  "required": [
                                                    "personId",
                                                    "version"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The person's photo, when they have one."
                                                },
                                                "via": {
                                                  "type": "object",
                                                  "properties": {
                                                    "kind": {
                                                      "type": "string",
                                                      "enum": [
                                                        "connection",
                                                        "key"
                                                      ],
                                                      "description": "connection for an app connected by sign-in, key for an API key."
                                                    },
                                                    "name": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The app's or the key's name, as Werk shows it."
                                                    },
                                                    "verified": {
                                                      "type": "boolean",
                                                      "description": "True when Werk verified the app's identity."
                                                    },
                                                    "label": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The caption Werk shows beside the change, in the reader's language."
                                                    }
                                                  },
                                                  "required": [
                                                    "kind",
                                                    "name",
                                                    "verified",
                                                    "label"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "displayName",
                                                "initials",
                                                "isViewer"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "connector",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The name Werk shows for a change made without a person."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "label"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "const": "schedule",
                                                  "description": "user for a person; connector or schedule for a change Werk made without one."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The name Werk shows for a change made without a person."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "label"
                                              ],
                                              "additionalProperties": false
                                            }
                                          ]
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "Who added what matched, or null when no longer known."
                                    },
                                    "at": {
                                      "type": "string",
                                      "description": "When what matched was added."
                                    },
                                    "document": {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The document's id."
                                        },
                                        "filename": {
                                          "type": "string",
                                          "description": "The document's name."
                                        },
                                        "page": {
                                          "type": "integer",
                                          "minimum": 1,
                                          "maximum": 9007199254740991,
                                          "description": "The part of the document it matched in, counted from 1."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "filename",
                                        "page"
                                      ],
                                      "additionalProperties": false,
                                      "description": "For a document, which one and where."
                                    }
                                  },
                                  "required": [
                                    "in",
                                    "text",
                                    "by",
                                    "at",
                                    "document"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "description": "With words, where on the card they matched."
                          }
                        },
                        "required": [
                          "project",
                          "item",
                          "foundBy",
                          "matches"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The cards found, in the order asked."
                    },
                    "total": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many cards match in all, past this page included."
                    },
                    "complete": {
                      "type": "boolean",
                      "description": "False when the search read as deep as it goes, so more cards may match than total says."
                    },
                    "byMeaning": {
                      "type": [
                        "boolean",
                        "null"
                      ],
                      "description": "With words, true when the search also looked by meaning; null without words."
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "items",
                    "total",
                    "complete",
                    "byMeaning",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "items": [
                    {
                      "project": {
                        "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                        "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                        "name": "Harbor Street kitchen",
                        "finalStep": {
                          "id": "paid",
                          "label": "Paid"
                        }
                      },
                      "item": {
                        "outcome": "open",
                        "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "ref": "#12",
                        "title": "Replace the leaking sink faucet",
                        "language": "en-US",
                        "status": {
                          "key": "waiting_parts",
                          "label": "Waiting for parts",
                          "category": "active",
                          "bucket": "waiting"
                        },
                        "dueNoticeLead": "at_due",
                        "due": null,
                        "assignee": {
                          "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                          "displayName": "Tom Okafor",
                          "initials": "TO"
                        },
                        "version": 4,
                        "number": 12,
                        "currentStep": {
                          "id": "waiting_parts",
                          "label": "Waiting for parts",
                          "bucket": "waiting"
                        },
                        "archived": false,
                        "counts": {
                          "photos": 1,
                          "updates": 1,
                          "documents": 0
                        }
                      },
                      "foundBy": [
                        "words"
                      ],
                      "matches": [
                        {
                          "in": "title"
                        }
                      ]
                    }
                  ],
                  "total": 1,
                  "complete": true,
                  "byMeaning": true,
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/files": {
      "get": {
        "operationId": "GET /api/v1/files",
        "tags": [
          "files"
        ],
        "summary": "Search files",
        "description": "The photos and documents on the cards of the key's person's projects, listed by filters or searched by words.\n\nWith q, Werk looks in file names, in what it read in photos and documents, and by meaning; without it, files are listed newest first. Each file comes with its card and project.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "The words to look for; left out, files are listed by the other filters.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "example": "faucet"
          },
          {
            "name": "in",
            "in": "query",
            "required": false,
            "description": "Where to look for the words, comma separated: name, description, text, summary, pages; left out, everywhere.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "projects",
            "in": "query",
            "required": false,
            "description": "Project ids, comma separated; left out, every project of the key's person.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "card",
            "in": "query",
            "required": false,
            "description": "A card's id, to keep that card's files only.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Keeps files of one kind only.",
            "schema": {
              "type": "string",
              "enum": [
                "photo",
                "document"
              ]
            },
            "example": "photo"
          },
          {
            "name": "attachedBy",
            "in": "query",
            "required": false,
            "description": "A person's id, to keep the files they added.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            }
          },
          {
            "name": "attachedFrom",
            "in": "query",
            "required": false,
            "description": "Keeps files added from this day or moment on: YYYY-MM-DD in the key's person's time zone, or an ISO 8601 date and time with Z or an offset.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "attachedBefore",
            "in": "query",
            "required": false,
            "description": "Keeps files added before this day or moment, in the same forms as attachedFrom.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                },
                {
                  "type": "string",
                  "format": "date-time",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                }
              ]
            }
          },
          {
            "name": "reading",
            "in": "query",
            "required": false,
            "description": "Reading states, comma separated, to keep files in them: not_read, reading, awaiting_confirmation, ready or failed; a photo is never awaiting_confirmation.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "relevance, only with q, or attached; left out, relevance with q and attached without.",
            "schema": {
              "type": "string",
              "enum": [
                "relevance",
                "attached"
              ]
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "The order of the sort; left out, desc: newest first when sorted by attached.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many files a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The files found.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "project": {
                            "type": "object",
                            "properties": {
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project's id."
                              },
                              "conversationId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id Werk's apps use for the key's person's view of the project."
                              },
                              "name": {
                                "type": "string",
                                "description": "The project's name."
                              },
                              "finalStep": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "description": "The step's id."
                                  },
                                  "label": {
                                    "type": "string",
                                    "description": "The step's name."
                                  }
                                },
                                "required": [
                                  "id",
                                  "label"
                                ],
                                "additionalProperties": false,
                                "description": "The project's last step, the one that ends the work."
                              }
                            },
                            "required": [
                              "projectId",
                              "conversationId",
                              "name",
                              "finalStep"
                            ],
                            "additionalProperties": false,
                            "description": "The file's project."
                          },
                          "item": {
                            "type": "object",
                            "properties": {
                              "outcome": {
                                "type": "string",
                                "enum": [
                                  "open",
                                  "completed",
                                  "not_completed"
                                ],
                                "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                              },
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "ref": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The card's number as people write it, with # before it."
                              },
                              "title": {
                                "type": "string",
                                "description": "The card's title, as written."
                              },
                              "language": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The language the card's title and description are written in."
                              },
                              "titleTranslation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The title in the reader's language, when it is written in another."
                              },
                              "status": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The id of the step the card is on."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The step's name."
                                  },
                                  "category": {
                                    "type": "string",
                                    "enum": [
                                      "open",
                                      "active",
                                      "done"
                                    ],
                                    "description": "open on a new step, done on the project's last step, active on any other step."
                                  },
                                  "bucket": {
                                    "type": "string",
                                    "enum": [
                                      "new",
                                      "in_progress",
                                      "waiting",
                                      "resolved",
                                      "closed"
                                    ],
                                    "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                  },
                                  "labelLanguage": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                  },
                                  "labelTranslation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The step's name in the reader's language, when it is written in another."
                                  }
                                },
                                "required": [
                                  "key",
                                  "label",
                                  "category"
                                ],
                                "additionalProperties": false,
                                "description": "The step the card is on, with where that step sits in the work."
                              },
                              "dueNoticeLead": {
                                "type": "string",
                                "enum": [
                                  "none",
                                  "at_due",
                                  "15_minutes",
                                  "1_hour",
                                  "2_hours",
                                  "1_day",
                                  "2_days"
                                ],
                                "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                              },
                              "dueSetBy": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "displayName": {
                                        "type": "string",
                                        "description": "That person's name."
                                      }
                                    },
                                    "required": [
                                      "displayName"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who set the due moment; present only for a due date with a time."
                              },
                              "due": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "date",
                                            "description": "date for a due day with no time, datetime for a due moment."
                                          },
                                          "date": {
                                            "type": "string",
                                            "format": "date",
                                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                            "description": "The due day, as YYYY-MM-DD."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "date"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "datetime",
                                            "description": "date for a due day with no time, datetime for a due moment."
                                          },
                                          "at": {
                                            "type": "string",
                                            "format": "date-time",
                                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                            "description": "The due moment, as an ISO 8601 date and time with its offset."
                                          },
                                          "enteredTimeZone": {
                                            "type": [
                                              "string",
                                              "null"
                                            ],
                                            "description": "The time zone the due moment was given in, when known."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "at"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's due date, or null when it has none."
                              },
                              "assignee": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "personId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The holder's person id."
                                      },
                                      "displayName": {
                                        "type": "string",
                                        "description": "The holder's name as the project shows it."
                                      },
                                      "initials": {
                                        "type": "string",
                                        "description": "The holder's initials, for an avatar with no photo."
                                      },
                                      "photo": {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person whose photo it is."
                                          },
                                          "version": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                          }
                                        },
                                        "required": [
                                          "personId",
                                          "version"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The holder's photo, when they have one."
                                      }
                                    },
                                    "required": [
                                      "displayName"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's holder, or null when the card is free."
                              },
                              "version": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 9007199254740991,
                                "description": "The card's version, which grows with every change to it."
                              },
                              "number": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's number in its project, unique there and never reused."
                              },
                              "currentStep": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The step's id; a change of step sends it as stepId."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The step's name."
                                      },
                                      "bucket": {
                                        "type": "string",
                                        "enum": [
                                          "new",
                                          "in_progress",
                                          "waiting",
                                          "resolved",
                                          "closed"
                                        ],
                                        "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                      },
                                      "labelLanguage": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                      },
                                      "labelTranslation": {
                                        "type": "object",
                                        "properties": {
                                          "language": {
                                            "type": "string",
                                            "minLength": 2,
                                            "maxLength": 64,
                                            "description": "The reader's language the text is translated into."
                                          },
                                          "state": {
                                            "type": "string",
                                            "enum": [
                                              "ready",
                                              "pending",
                                              "failed",
                                              "paused"
                                            ],
                                            "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                          },
                                          "text": {
                                            "type": "string",
                                            "description": "The translated text, present once ready."
                                          }
                                        },
                                        "required": [
                                          "language",
                                          "state"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The step's name in the reader's language, when it is written in another."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "label",
                                      "bucket"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The card's step among its project's steps, as the project defines it."
                              },
                              "archived": {
                                "type": "boolean",
                                "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                              },
                              "counts": {
                                "type": "object",
                                "properties": {
                                  "photos": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Photos on the card."
                                  },
                                  "updates": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Updates on the card."
                                  },
                                  "documents": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Documents on the card."
                                  },
                                  "checklist": {
                                    "type": "object",
                                    "properties": {
                                      "done": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "List items checked."
                                      },
                                      "total": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "List items in all."
                                      }
                                    },
                                    "required": [
                                      "done",
                                      "total"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The card's list: its items checked and in all; absent when the card has no list."
                                  }
                                },
                                "required": [
                                  "photos",
                                  "updates",
                                  "documents"
                                ],
                                "additionalProperties": false,
                                "description": "How much the card holds."
                              },
                              "allowedActions": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "take_card",
                                    "assign_card",
                                    "give_back_card",
                                    "move_card",
                                    "archive_card",
                                    "unarchive_card",
                                    "edit_card",
                                    "set_card_due",
                                    "add_update",
                                    "create_reminder",
                                    "link_duplicate",
                                    "add_entries",
                                    "rename_entry",
                                    "remove_entry",
                                    "reorder_entries",
                                    "follow_card",
                                    "unfollow_card",
                                    "follow_invitation",
                                    "tick_entry",
                                    "untick_entry",
                                    "set_due_notice"
                                  ]
                                },
                                "description": "The changes the key's person may make to this card by hand now, by action name."
                              }
                            },
                            "required": [
                              "id",
                              "ref",
                              "title",
                              "status",
                              "due",
                              "assignee",
                              "version"
                            ],
                            "additionalProperties": false,
                            "description": "The card the file is on."
                          },
                          "file": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "photo",
                                    "description": "photo or document."
                                  },
                                  "updateId": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The update the file came with, or null for a file added to the card itself."
                                  },
                                  "photo": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The photo's id on the card; removing it names this id."
                                      },
                                      "attachedBy": {
                                        "anyOf": [
                                          {
                                            "oneOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "user",
                                                    "description": "user for a person; connector or schedule for a change Werk made without one."
                                                  },
                                                  "displayName": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The person's name as the project shows it."
                                                  },
                                                  "initials": {
                                                    "type": "string",
                                                    "description": "The person's initials, for an avatar with no photo."
                                                  },
                                                  "isViewer": {
                                                    "type": "boolean",
                                                    "description": "True when the person is the key's own person."
                                                  },
                                                  "photo": {
                                                    "type": "object",
                                                    "properties": {
                                                      "personId": {
                                                        "type": "string",
                                                        "format": "uuid",
                                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                        "description": "The person whose photo it is."
                                                      },
                                                      "version": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                      }
                                                    },
                                                    "required": [
                                                      "personId",
                                                      "version"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The person's photo, when they have one."
                                                  },
                                                  "via": {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "enum": [
                                                          "connection",
                                                          "key"
                                                        ],
                                                        "description": "connection for an app connected by sign-in, key for an API key."
                                                      },
                                                      "name": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The app's or the key's name, as Werk shows it."
                                                      },
                                                      "verified": {
                                                        "type": "boolean",
                                                        "description": "True when Werk verified the app's identity."
                                                      },
                                                      "label": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The caption Werk shows beside the change, in the reader's language."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "name",
                                                      "verified",
                                                      "label"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "displayName",
                                                  "initials",
                                                  "isViewer"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "connector",
                                                    "description": "user for a person; connector or schedule for a change Werk made without one."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The name Werk shows for a change made without a person."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "label"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "const": "schedule",
                                                    "description": "user for a person; connector or schedule for a change Werk made without one."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The name Werk shows for a change made without a person."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "label"
                                                ],
                                                "additionalProperties": false
                                              }
                                            ]
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "Who added the photo, or null when no longer known."
                                      },
                                      "asset": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The file's id."
                                          },
                                          "kind": {
                                            "type": "string",
                                            "const": "image",
                                            "description": "What the file is: a photo, a voice recording or a document."
                                          },
                                          "filename": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 255,
                                            "description": "The document's name; only a document has one."
                                          },
                                          "format": {
                                            "type": "string",
                                            "enum": [
                                              "pdf",
                                              "docx",
                                              "xlsx",
                                              "csv",
                                              "txt",
                                              "md"
                                            ],
                                            "description": "The document's format; only a document has one."
                                          },
                                          "mimeType": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The file's media type."
                                          },
                                          "sizeBytes": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The file's size in bytes."
                                          },
                                          "width": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                                          },
                                          "height": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                                          },
                                          "durationSeconds": {
                                            "type": "number",
                                            "exclusiveMinimum": 0,
                                            "maximum": 300,
                                            "description": "The recording's length in seconds; only a voice recording has one."
                                          },
                                          "available": {
                                            "type": "boolean",
                                            "description": "False once the file's bytes were released and it can no longer be read."
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "kind",
                                          "mimeType",
                                          "sizeBytes"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The photo's file."
                                      },
                                      "attachedAt": {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                        "description": "When the photo was added to the card."
                                      },
                                      "removable": {
                                        "type": "boolean",
                                        "description": "True when the key's person may take this photo off the card now."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "attachedBy",
                                      "asset",
                                      "attachedAt",
                                      "removable"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The photo, for a photo."
                                  },
                                  "reading": {
                                    "type": "object",
                                    "properties": {
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "reading",
                                          "not_read",
                                          "failed"
                                        ],
                                        "description": "ready once read, reading while Werk reads it, not_read when it will not be read, failed when reading failed."
                                      },
                                      "description": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "maxLength": 800
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "What Werk sees in the photo, or null."
                                      },
                                      "text": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "maxLength": 4000
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The text Werk read in the photo, or null."
                                      }
                                    },
                                    "required": [
                                      "state",
                                      "description",
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "What Werk read in the photo."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "updateId",
                                  "photo",
                                  "reading"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "document",
                                    "description": "photo or document."
                                  },
                                  "updateId": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The update the file came with, or null for a file added to the card itself."
                                  },
                                  "attachedBy": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "user",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "displayName": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The person's name as the project shows it."
                                              },
                                              "initials": {
                                                "type": "string",
                                                "description": "The person's initials, for an avatar with no photo."
                                              },
                                              "isViewer": {
                                                "type": "boolean",
                                                "description": "True when the person is the key's own person."
                                              },
                                              "photo": {
                                                "type": "object",
                                                "properties": {
                                                  "personId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person whose photo it is."
                                                  },
                                                  "version": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                  }
                                                },
                                                "required": [
                                                  "personId",
                                                  "version"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The person's photo, when they have one."
                                              },
                                              "via": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "connection",
                                                      "key"
                                                    ],
                                                    "description": "connection for an app connected by sign-in, key for an API key."
                                                  },
                                                  "name": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The app's or the key's name, as Werk shows it."
                                                  },
                                                  "verified": {
                                                    "type": "boolean",
                                                    "description": "True when Werk verified the app's identity."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "name",
                                                  "verified",
                                                  "label"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "displayName",
                                              "initials",
                                              "isViewer"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "connector",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "schedule",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who added the document, or null when no longer known."
                                  },
                                  "attachedAt": {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                    "description": "When the document was added."
                                  },
                                  "document": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The document's id."
                                      },
                                      "itemId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The card the document is on."
                                      },
                                      "filename": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 255,
                                        "description": "The document's name."
                                      },
                                      "mimeType": {
                                        "type": "string",
                                        "enum": [
                                          "application/pdf",
                                          "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                          "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                          "text/csv",
                                          "text/plain",
                                          "text/markdown"
                                        ],
                                        "description": "The document's media type."
                                      },
                                      "revision": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The document's revision, which grows each time its file is replaced."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "not_read",
                                          "awaiting_confirmation",
                                          "reading",
                                          "failed",
                                          "ready"
                                        ],
                                        "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                                      },
                                      "version": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                                      },
                                      "totalSources": {
                                        "anyOf": [
                                          {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "How many parts the document has, or null while not known."
                                      },
                                      "readSources": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "How many parts Werk read."
                                      },
                                      "truncated": {
                                        "type": "boolean",
                                        "description": "True when Werk read only the document's first parts."
                                      },
                                      "summary": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 2000
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "Werk's summary of the document, or null."
                                      },
                                      "fields": {
                                        "anyOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "issuer": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "value": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "maxLength": 512,
                                                        "description": "The issuer as read."
                                                      },
                                                      "source": {
                                                        "type": "object",
                                                        "properties": {
                                                          "documentId": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The document's id."
                                                          },
                                                          "revision": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The revision it was read in."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                          },
                                                          "sha256": {
                                                            "type": "string",
                                                            "pattern": "^[a-f0-9]{64}$",
                                                            "description": "The SHA-256 of the file it was read from."
                                                          },
                                                          "location": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "pdf_page",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "page": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The PDF page."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "page"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "section",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "section": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The section, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "section"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "paragraph",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "paragraph": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The paragraph, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "paragraph"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sheet_rows",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "sheet": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The sheet's name."
                                                                  },
                                                                  "firstRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first row."
                                                                  },
                                                                  "lastRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last row."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "sheet",
                                                                  "firstRow",
                                                                  "lastRow"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "lines",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "firstLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first line."
                                                                  },
                                                                  "lastLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last line."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "firstLine",
                                                                  "lastLine"
                                                                ],
                                                                "additionalProperties": false
                                                              }
                                                            ],
                                                            "description": "Where in the file the part is."
                                                          }
                                                        },
                                                        "required": [
                                                          "documentId",
                                                          "revision",
                                                          "page",
                                                          "sha256",
                                                          "location"
                                                        ],
                                                        "additionalProperties": false,
                                                        "description": "The part of the document it was read from."
                                                      }
                                                    },
                                                    "required": [
                                                      "value",
                                                      "source"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "The issuer Werk read in the document, or null when it found none."
                                              },
                                              "number": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "value": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "maxLength": 128,
                                                        "description": "The document's number as read."
                                                      },
                                                      "source": {
                                                        "type": "object",
                                                        "properties": {
                                                          "documentId": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The document's id."
                                                          },
                                                          "revision": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The revision it was read in."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                          },
                                                          "sha256": {
                                                            "type": "string",
                                                            "pattern": "^[a-f0-9]{64}$",
                                                            "description": "The SHA-256 of the file it was read from."
                                                          },
                                                          "location": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "pdf_page",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "page": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The PDF page."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "page"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "section",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "section": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The section, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "section"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "paragraph",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "paragraph": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The paragraph, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "paragraph"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sheet_rows",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "sheet": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The sheet's name."
                                                                  },
                                                                  "firstRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first row."
                                                                  },
                                                                  "lastRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last row."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "sheet",
                                                                  "firstRow",
                                                                  "lastRow"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "lines",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "firstLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first line."
                                                                  },
                                                                  "lastLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last line."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "firstLine",
                                                                  "lastLine"
                                                                ],
                                                                "additionalProperties": false
                                                              }
                                                            ],
                                                            "description": "Where in the file the part is."
                                                          }
                                                        },
                                                        "required": [
                                                          "documentId",
                                                          "revision",
                                                          "page",
                                                          "sha256",
                                                          "location"
                                                        ],
                                                        "additionalProperties": false,
                                                        "description": "The part of the document it was read from."
                                                      }
                                                    },
                                                    "required": [
                                                      "value",
                                                      "source"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "The document's number Werk read in the document, or null when it found none."
                                              },
                                              "date": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "value": {
                                                        "type": "string",
                                                        "format": "date",
                                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                        "description": "The date as read, as YYYY-MM-DD."
                                                      },
                                                      "source": {
                                                        "type": "object",
                                                        "properties": {
                                                          "documentId": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The document's id."
                                                          },
                                                          "revision": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The revision it was read in."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                          },
                                                          "sha256": {
                                                            "type": "string",
                                                            "pattern": "^[a-f0-9]{64}$",
                                                            "description": "The SHA-256 of the file it was read from."
                                                          },
                                                          "location": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "pdf_page",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "page": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The PDF page."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "page"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "section",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "section": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The section, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "section"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "paragraph",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "paragraph": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The paragraph, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "paragraph"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sheet_rows",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "sheet": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The sheet's name."
                                                                  },
                                                                  "firstRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first row."
                                                                  },
                                                                  "lastRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last row."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "sheet",
                                                                  "firstRow",
                                                                  "lastRow"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "lines",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "firstLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first line."
                                                                  },
                                                                  "lastLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last line."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "firstLine",
                                                                  "lastLine"
                                                                ],
                                                                "additionalProperties": false
                                                              }
                                                            ],
                                                            "description": "Where in the file the part is."
                                                          }
                                                        },
                                                        "required": [
                                                          "documentId",
                                                          "revision",
                                                          "page",
                                                          "sha256",
                                                          "location"
                                                        ],
                                                        "additionalProperties": false,
                                                        "description": "The part of the document it was read from."
                                                      }
                                                    },
                                                    "required": [
                                                      "value",
                                                      "source"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "The date Werk read in the document, or null when it found none."
                                              },
                                              "total": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "value": {
                                                        "type": "string",
                                                        "maxLength": 128,
                                                        "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                                        "description": "The total as read, a decimal number with a point."
                                                      },
                                                      "source": {
                                                        "type": "object",
                                                        "properties": {
                                                          "documentId": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The document's id."
                                                          },
                                                          "revision": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The revision it was read in."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                          },
                                                          "sha256": {
                                                            "type": "string",
                                                            "pattern": "^[a-f0-9]{64}$",
                                                            "description": "The SHA-256 of the file it was read from."
                                                          },
                                                          "location": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "pdf_page",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "page": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The PDF page."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "page"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "section",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "section": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The section, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "section"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "paragraph",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "paragraph": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The paragraph, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "paragraph"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sheet_rows",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "sheet": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The sheet's name."
                                                                  },
                                                                  "firstRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first row."
                                                                  },
                                                                  "lastRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last row."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "sheet",
                                                                  "firstRow",
                                                                  "lastRow"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "lines",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "firstLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first line."
                                                                  },
                                                                  "lastLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last line."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "firstLine",
                                                                  "lastLine"
                                                                ],
                                                                "additionalProperties": false
                                                              }
                                                            ],
                                                            "description": "Where in the file the part is."
                                                          }
                                                        },
                                                        "required": [
                                                          "documentId",
                                                          "revision",
                                                          "page",
                                                          "sha256",
                                                          "location"
                                                        ],
                                                        "additionalProperties": false,
                                                        "description": "The part of the document it was read from."
                                                      }
                                                    },
                                                    "required": [
                                                      "value",
                                                      "source"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "The total Werk read in the document, or null when it found none."
                                              },
                                              "currency": {
                                                "anyOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "value": {
                                                        "type": "string",
                                                        "pattern": "^[A-Z]{3}$",
                                                        "description": "The currency as read, its ISO 4217 code."
                                                      },
                                                      "source": {
                                                        "type": "object",
                                                        "properties": {
                                                          "documentId": {
                                                            "type": "string",
                                                            "minLength": 1,
                                                            "description": "The document's id."
                                                          },
                                                          "revision": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The revision it was read in."
                                                          },
                                                          "page": {
                                                            "type": "integer",
                                                            "exclusiveMinimum": 0,
                                                            "maximum": 9007199254740991,
                                                            "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                          },
                                                          "sha256": {
                                                            "type": "string",
                                                            "pattern": "^[a-f0-9]{64}$",
                                                            "description": "The SHA-256 of the file it was read from."
                                                          },
                                                          "location": {
                                                            "oneOf": [
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "pdf_page",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "page": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The PDF page."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "page"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "section",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "section": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The section, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "section"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "paragraph",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "paragraph": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The paragraph, counted from 1."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "paragraph"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "sheet_rows",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "sheet": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The sheet's name."
                                                                  },
                                                                  "firstRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first row."
                                                                  },
                                                                  "lastRow": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last row."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "sheet",
                                                                  "firstRow",
                                                                  "lastRow"
                                                                ],
                                                                "additionalProperties": false
                                                              },
                                                              {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "const": "lines",
                                                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                                  },
                                                                  "firstLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's first line."
                                                                  },
                                                                  "lastLine": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The part's last line."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "firstLine",
                                                                  "lastLine"
                                                                ],
                                                                "additionalProperties": false
                                                              }
                                                            ],
                                                            "description": "Where in the file the part is."
                                                          }
                                                        },
                                                        "required": [
                                                          "documentId",
                                                          "revision",
                                                          "page",
                                                          "sha256",
                                                          "location"
                                                        ],
                                                        "additionalProperties": false,
                                                        "description": "The part of the document it was read from."
                                                      }
                                                    },
                                                    "required": [
                                                      "value",
                                                      "source"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "null"
                                                  }
                                                ],
                                                "description": "The currency Werk read in the document, or null when it found none."
                                              }
                                            },
                                            "required": [
                                              "issuer",
                                              "number",
                                              "date",
                                              "total",
                                              "currency"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                                      },
                                      "failureCode": {
                                        "anyOf": [
                                          {
                                            "type": "string",
                                            "enum": [
                                              "parse_failed",
                                              "encrypted",
                                              "unsupported_format",
                                              "transcription_failed",
                                              "summary_failed",
                                              "invalid_output",
                                              "access_lost",
                                              "limit_exceeded",
                                              "provider_unavailable"
                                            ]
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "Why reading failed, or null."
                                      },
                                      "units": {
                                        "anyOf": [
                                          {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                                      },
                                      "pages": {
                                        "anyOf": [
                                          {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                                      },
                                      "sheets": {
                                        "anyOf": [
                                          {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          {
                                            "type": "null"
                                          }
                                        ],
                                        "description": "A workbook's sheets with data; null for other files or when not known."
                                      },
                                      "removable": {
                                        "type": "boolean",
                                        "description": "True when the key's person may take this document off the card now."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "itemId",
                                      "filename",
                                      "mimeType",
                                      "revision",
                                      "state",
                                      "version",
                                      "totalSources",
                                      "readSources",
                                      "truncated",
                                      "summary",
                                      "fields",
                                      "failureCode",
                                      "units",
                                      "pages",
                                      "sheets",
                                      "removable"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The document, for a document."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "updateId",
                                  "attachedBy",
                                  "attachedAt",
                                  "document"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "The file."
                          },
                          "foundBy": {
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "words",
                                "meaning"
                              ]
                            },
                            "description": "With words, how the file was found: by its words, by meaning, or both; empty without words."
                          },
                          "matches": {
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "enum": [
                                        "name",
                                        "description",
                                        "text",
                                        "summary"
                                      ],
                                      "description": "Where it matched: a document's name, Werk's description of a photo, the text Werk read in a photo, Werk's summary of a document, or a part of a document."
                                    }
                                  },
                                  "required": [
                                    "in"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "in": {
                                      "type": "string",
                                      "const": "pages",
                                      "description": "Where it matched: a document's name, Werk's description of a photo, the text Werk read in a photo, Werk's summary of a document, or a part of a document."
                                    },
                                    "page": {
                                      "type": "integer",
                                      "minimum": 1,
                                      "maximum": 9007199254740991,
                                      "description": "For a part of a document, the part, counted from 1."
                                    },
                                    "location": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "pdf_page",
                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                            },
                                            "page": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The PDF page."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "page"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "section",
                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                            },
                                            "section": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The section, counted from 1."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "section"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "paragraph",
                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                            },
                                            "paragraph": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The paragraph, counted from 1."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "paragraph"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "sheet_rows",
                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                            },
                                            "sheet": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The sheet's name."
                                            },
                                            "firstRow": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part's first row."
                                            },
                                            "lastRow": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part's last row."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "sheet",
                                            "firstRow",
                                            "lastRow"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "lines",
                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                            },
                                            "firstLine": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part's first line."
                                            },
                                            "lastLine": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The part's last line."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "firstLine",
                                            "lastLine"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ],
                                      "description": "For a part of a document, where it is in the file."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "For a part of a document, the start of the text that matched."
                                    }
                                  },
                                  "required": [
                                    "in",
                                    "page",
                                    "location",
                                    "text"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "description": "With words, where in the file they matched."
                          }
                        },
                        "required": [
                          "project",
                          "item",
                          "file",
                          "foundBy",
                          "matches"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The files found, in the order asked."
                    },
                    "total": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many files match in all, past this page included."
                    },
                    "complete": {
                      "type": "boolean",
                      "description": "False when the search read as deep as it goes, so more files may match than total says."
                    },
                    "unread": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "With words, how many files that pass the other filters are not read yet, or read only in part; null without words."
                    },
                    "byMeaning": {
                      "type": [
                        "boolean",
                        "null"
                      ],
                      "description": "With words, true when the search also looked by meaning; null without words."
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "items",
                    "total",
                    "complete",
                    "unread",
                    "byMeaning",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "items": [
                    {
                      "project": {
                        "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                        "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                        "name": "Harbor Street kitchen",
                        "finalStep": {
                          "id": "paid",
                          "label": "Paid"
                        }
                      },
                      "item": {
                        "outcome": "open",
                        "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "ref": "#12",
                        "title": "Replace the leaking sink faucet",
                        "language": "en-US",
                        "status": {
                          "key": "waiting_parts",
                          "label": "Waiting for parts",
                          "category": "active",
                          "bucket": "waiting"
                        },
                        "dueNoticeLead": "at_due",
                        "due": null,
                        "assignee": {
                          "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                          "displayName": "Tom Okafor",
                          "initials": "TO"
                        },
                        "version": 4,
                        "number": 12,
                        "currentStep": {
                          "id": "waiting_parts",
                          "label": "Waiting for parts",
                          "bucket": "waiting"
                        },
                        "archived": false,
                        "counts": {
                          "photos": 1,
                          "updates": 1,
                          "documents": 0
                        }
                      },
                      "file": {
                        "kind": "photo",
                        "updateId": "c9a3e7f1-4d6b-4f80-a2c8-5b1e9d3f7a46",
                        "photo": {
                          "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                          "attachedBy": {
                            "kind": "user",
                            "displayName": "Tom Okafor",
                            "initials": "TO",
                            "isViewer": false
                          },
                          "asset": {
                            "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                            "kind": "image",
                            "mimeType": "image/jpeg",
                            "sizeBytes": 482113,
                            "width": 1600,
                            "height": 1200
                          },
                          "attachedAt": "2026-11-19T16:12:00.000Z",
                          "removable": true
                        },
                        "reading": {
                          "state": "ready",
                          "description": "A chrome kitchen faucet with a cracked base, under a stainless sink.",
                          "text": null
                        }
                      },
                      "foundBy": [
                        "words",
                        "meaning"
                      ],
                      "matches": [
                        {
                          "in": "description"
                        }
                      ]
                    }
                  ],
                  "total": 1,
                  "complete": true,
                  "unread": 0,
                  "byMeaning": true,
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_card_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/files/{fileId}": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/files/:fileId",
        "tags": [
          "files"
        ],
        "summary": "Get a card's file",
        "description": "One photo or document on a card, with what Werk read in it.\n\nA photo is named by its id on the card, a document by its own id.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "fileId",
            "in": "path",
            "required": true,
            "description": "The photo's or the document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "file": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "photo",
                              "description": "photo or document."
                            },
                            "updateId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The update the file came with, or null for a file added to the card itself."
                            },
                            "photo": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The photo's id on the card; removing it names this id."
                                },
                                "attachedBy": {
                                  "anyOf": [
                                    {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "user",
                                              "description": "user for a person; connector or schedule for a change Werk made without one."
                                            },
                                            "displayName": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The person's name as the project shows it."
                                            },
                                            "initials": {
                                              "type": "string",
                                              "description": "The person's initials, for an avatar with no photo."
                                            },
                                            "isViewer": {
                                              "type": "boolean",
                                              "description": "True when the person is the key's own person."
                                            },
                                            "photo": {
                                              "type": "object",
                                              "properties": {
                                                "personId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The person whose photo it is."
                                                },
                                                "version": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                }
                                              },
                                              "required": [
                                                "personId",
                                                "version"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The person's photo, when they have one."
                                            },
                                            "via": {
                                              "type": "object",
                                              "properties": {
                                                "kind": {
                                                  "type": "string",
                                                  "enum": [
                                                    "connection",
                                                    "key"
                                                  ],
                                                  "description": "connection for an app connected by sign-in, key for an API key."
                                                },
                                                "name": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The app's or the key's name, as Werk shows it."
                                                },
                                                "verified": {
                                                  "type": "boolean",
                                                  "description": "True when Werk verified the app's identity."
                                                },
                                                "label": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The caption Werk shows beside the change, in the reader's language."
                                                }
                                              },
                                              "required": [
                                                "kind",
                                                "name",
                                                "verified",
                                                "label"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "displayName",
                                            "initials",
                                            "isViewer"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "connector",
                                              "description": "user for a person; connector or schedule for a change Werk made without one."
                                            },
                                            "label": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The name Werk shows for a change made without a person."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "label"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "const": "schedule",
                                              "description": "user for a person; connector or schedule for a change Werk made without one."
                                            },
                                            "label": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The name Werk shows for a change made without a person."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "label"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Who added the photo, or null when no longer known."
                                },
                                "asset": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The file's id."
                                    },
                                    "kind": {
                                      "type": "string",
                                      "const": "image",
                                      "description": "What the file is: a photo, a voice recording or a document."
                                    },
                                    "filename": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 255,
                                      "description": "The document's name; only a document has one."
                                    },
                                    "format": {
                                      "type": "string",
                                      "enum": [
                                        "pdf",
                                        "docx",
                                        "xlsx",
                                        "csv",
                                        "txt",
                                        "md"
                                      ],
                                      "description": "The document's format; only a document has one."
                                    },
                                    "mimeType": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The file's media type."
                                    },
                                    "sizeBytes": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The file's size in bytes."
                                    },
                                    "width": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                                    },
                                    "height": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                                    },
                                    "durationSeconds": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "maximum": 300,
                                      "description": "The recording's length in seconds; only a voice recording has one."
                                    },
                                    "available": {
                                      "type": "boolean",
                                      "description": "False once the file's bytes were released and it can no longer be read."
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "kind",
                                    "mimeType",
                                    "sizeBytes"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The photo's file."
                                },
                                "attachedAt": {
                                  "type": "string",
                                  "format": "date-time",
                                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                  "description": "When the photo was added to the card."
                                },
                                "removable": {
                                  "type": "boolean",
                                  "description": "True when the key's person may take this photo off the card now."
                                }
                              },
                              "required": [
                                "id",
                                "attachedBy",
                                "asset",
                                "attachedAt",
                                "removable"
                              ],
                              "additionalProperties": false,
                              "description": "The photo, for a photo."
                            },
                            "reading": {
                              "type": "object",
                              "properties": {
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "reading",
                                    "not_read",
                                    "failed"
                                  ],
                                  "description": "ready once read, reading while Werk reads it, not_read when it will not be read, failed when reading failed."
                                },
                                "description": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 800
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "What Werk sees in the photo, or null."
                                },
                                "text": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 4000
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The text Werk read in the photo, or null."
                                }
                              },
                              "required": [
                                "state",
                                "description",
                                "text"
                              ],
                              "additionalProperties": false,
                              "description": "What Werk read in the photo."
                            }
                          },
                          "required": [
                            "kind",
                            "updateId",
                            "photo",
                            "reading"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "document",
                              "description": "photo or document."
                            },
                            "updateId": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The update the file came with, or null for a file added to the card itself."
                            },
                            "attachedBy": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "user",
                                          "description": "user for a person; connector or schedule for a change Werk made without one."
                                        },
                                        "displayName": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The person's name as the project shows it."
                                        },
                                        "initials": {
                                          "type": "string",
                                          "description": "The person's initials, for an avatar with no photo."
                                        },
                                        "isViewer": {
                                          "type": "boolean",
                                          "description": "True when the person is the key's own person."
                                        },
                                        "photo": {
                                          "type": "object",
                                          "properties": {
                                            "personId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person whose photo it is."
                                            },
                                            "version": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                            }
                                          },
                                          "required": [
                                            "personId",
                                            "version"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The person's photo, when they have one."
                                        },
                                        "via": {
                                          "type": "object",
                                          "properties": {
                                            "kind": {
                                              "type": "string",
                                              "enum": [
                                                "connection",
                                                "key"
                                              ],
                                              "description": "connection for an app connected by sign-in, key for an API key."
                                            },
                                            "name": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The app's or the key's name, as Werk shows it."
                                            },
                                            "verified": {
                                              "type": "boolean",
                                              "description": "True when Werk verified the app's identity."
                                            },
                                            "label": {
                                              "type": "string",
                                              "minLength": 1,
                                              "description": "The caption Werk shows beside the change, in the reader's language."
                                            }
                                          },
                                          "required": [
                                            "kind",
                                            "name",
                                            "verified",
                                            "label"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "displayName",
                                        "initials",
                                        "isViewer"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "connector",
                                          "description": "user for a person; connector or schedule for a change Werk made without one."
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The name Werk shows for a change made without a person."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "label"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "schedule",
                                          "description": "user for a person; connector or schedule for a change Werk made without one."
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The name Werk shows for a change made without a person."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "label"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Who added the document, or null when no longer known."
                            },
                            "attachedAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the document was added."
                            },
                            "document": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The document's id."
                                },
                                "itemId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The card the document is on."
                                },
                                "filename": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 255,
                                  "description": "The document's name."
                                },
                                "mimeType": {
                                  "type": "string",
                                  "enum": [
                                    "application/pdf",
                                    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                    "text/csv",
                                    "text/plain",
                                    "text/markdown"
                                  ],
                                  "description": "The document's media type."
                                },
                                "revision": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The document's revision, which grows each time its file is replaced."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "not_read",
                                    "awaiting_confirmation",
                                    "reading",
                                    "failed",
                                    "ready"
                                  ],
                                  "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                                },
                                "version": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                                },
                                "totalSources": {
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "How many parts the document has, or null while not known."
                                },
                                "readSources": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "How many parts Werk read."
                                },
                                "truncated": {
                                  "type": "boolean",
                                  "description": "True when Werk read only the document's first parts."
                                },
                                "summary": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 2000
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Werk's summary of the document, or null."
                                },
                                "fields": {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "issuer": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "value": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "maxLength": 512,
                                                  "description": "The issuer as read."
                                                },
                                                "source": {
                                                  "type": "object",
                                                  "properties": {
                                                    "documentId": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The document's id."
                                                    },
                                                    "revision": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The revision it was read in."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                    },
                                                    "sha256": {
                                                      "type": "string",
                                                      "pattern": "^[a-f0-9]{64}$",
                                                      "description": "The SHA-256 of the file it was read from."
                                                    },
                                                    "location": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "pdf_page",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "page": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The PDF page."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "page"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "section",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "section": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The section, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "section"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "paragraph",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "paragraph": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The paragraph, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "paragraph"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sheet_rows",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "sheet": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "The sheet's name."
                                                            },
                                                            "firstRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first row."
                                                            },
                                                            "lastRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last row."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "sheet",
                                                            "firstRow",
                                                            "lastRow"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "lines",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "firstLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first line."
                                                            },
                                                            "lastLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last line."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "firstLine",
                                                            "lastLine"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ],
                                                      "description": "Where in the file the part is."
                                                    }
                                                  },
                                                  "required": [
                                                    "documentId",
                                                    "revision",
                                                    "page",
                                                    "sha256",
                                                    "location"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The part of the document it was read from."
                                                }
                                              },
                                              "required": [
                                                "value",
                                                "source"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The issuer Werk read in the document, or null when it found none."
                                        },
                                        "number": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "value": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "maxLength": 128,
                                                  "description": "The document's number as read."
                                                },
                                                "source": {
                                                  "type": "object",
                                                  "properties": {
                                                    "documentId": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The document's id."
                                                    },
                                                    "revision": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The revision it was read in."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                    },
                                                    "sha256": {
                                                      "type": "string",
                                                      "pattern": "^[a-f0-9]{64}$",
                                                      "description": "The SHA-256 of the file it was read from."
                                                    },
                                                    "location": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "pdf_page",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "page": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The PDF page."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "page"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "section",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "section": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The section, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "section"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "paragraph",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "paragraph": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The paragraph, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "paragraph"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sheet_rows",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "sheet": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "The sheet's name."
                                                            },
                                                            "firstRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first row."
                                                            },
                                                            "lastRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last row."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "sheet",
                                                            "firstRow",
                                                            "lastRow"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "lines",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "firstLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first line."
                                                            },
                                                            "lastLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last line."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "firstLine",
                                                            "lastLine"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ],
                                                      "description": "Where in the file the part is."
                                                    }
                                                  },
                                                  "required": [
                                                    "documentId",
                                                    "revision",
                                                    "page",
                                                    "sha256",
                                                    "location"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The part of the document it was read from."
                                                }
                                              },
                                              "required": [
                                                "value",
                                                "source"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The document's number Werk read in the document, or null when it found none."
                                        },
                                        "date": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "value": {
                                                  "type": "string",
                                                  "format": "date",
                                                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                  "description": "The date as read, as YYYY-MM-DD."
                                                },
                                                "source": {
                                                  "type": "object",
                                                  "properties": {
                                                    "documentId": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The document's id."
                                                    },
                                                    "revision": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The revision it was read in."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                    },
                                                    "sha256": {
                                                      "type": "string",
                                                      "pattern": "^[a-f0-9]{64}$",
                                                      "description": "The SHA-256 of the file it was read from."
                                                    },
                                                    "location": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "pdf_page",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "page": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The PDF page."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "page"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "section",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "section": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The section, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "section"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "paragraph",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "paragraph": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The paragraph, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "paragraph"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sheet_rows",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "sheet": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "The sheet's name."
                                                            },
                                                            "firstRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first row."
                                                            },
                                                            "lastRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last row."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "sheet",
                                                            "firstRow",
                                                            "lastRow"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "lines",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "firstLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first line."
                                                            },
                                                            "lastLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last line."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "firstLine",
                                                            "lastLine"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ],
                                                      "description": "Where in the file the part is."
                                                    }
                                                  },
                                                  "required": [
                                                    "documentId",
                                                    "revision",
                                                    "page",
                                                    "sha256",
                                                    "location"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The part of the document it was read from."
                                                }
                                              },
                                              "required": [
                                                "value",
                                                "source"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The date Werk read in the document, or null when it found none."
                                        },
                                        "total": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "value": {
                                                  "type": "string",
                                                  "maxLength": 128,
                                                  "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                                  "description": "The total as read, a decimal number with a point."
                                                },
                                                "source": {
                                                  "type": "object",
                                                  "properties": {
                                                    "documentId": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The document's id."
                                                    },
                                                    "revision": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The revision it was read in."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                    },
                                                    "sha256": {
                                                      "type": "string",
                                                      "pattern": "^[a-f0-9]{64}$",
                                                      "description": "The SHA-256 of the file it was read from."
                                                    },
                                                    "location": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "pdf_page",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "page": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The PDF page."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "page"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "section",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "section": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The section, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "section"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "paragraph",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "paragraph": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The paragraph, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "paragraph"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sheet_rows",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "sheet": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "The sheet's name."
                                                            },
                                                            "firstRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first row."
                                                            },
                                                            "lastRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last row."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "sheet",
                                                            "firstRow",
                                                            "lastRow"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "lines",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "firstLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first line."
                                                            },
                                                            "lastLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last line."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "firstLine",
                                                            "lastLine"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ],
                                                      "description": "Where in the file the part is."
                                                    }
                                                  },
                                                  "required": [
                                                    "documentId",
                                                    "revision",
                                                    "page",
                                                    "sha256",
                                                    "location"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The part of the document it was read from."
                                                }
                                              },
                                              "required": [
                                                "value",
                                                "source"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The total Werk read in the document, or null when it found none."
                                        },
                                        "currency": {
                                          "anyOf": [
                                            {
                                              "type": "object",
                                              "properties": {
                                                "value": {
                                                  "type": "string",
                                                  "pattern": "^[A-Z]{3}$",
                                                  "description": "The currency as read, its ISO 4217 code."
                                                },
                                                "source": {
                                                  "type": "object",
                                                  "properties": {
                                                    "documentId": {
                                                      "type": "string",
                                                      "minLength": 1,
                                                      "description": "The document's id."
                                                    },
                                                    "revision": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The revision it was read in."
                                                    },
                                                    "page": {
                                                      "type": "integer",
                                                      "exclusiveMinimum": 0,
                                                      "maximum": 9007199254740991,
                                                      "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                    },
                                                    "sha256": {
                                                      "type": "string",
                                                      "pattern": "^[a-f0-9]{64}$",
                                                      "description": "The SHA-256 of the file it was read from."
                                                    },
                                                    "location": {
                                                      "oneOf": [
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "pdf_page",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "page": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The PDF page."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "page"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "section",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "section": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The section, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "section"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "paragraph",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "paragraph": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The paragraph, counted from 1."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "paragraph"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "sheet_rows",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "sheet": {
                                                              "type": "string",
                                                              "minLength": 1,
                                                              "description": "The sheet's name."
                                                            },
                                                            "firstRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first row."
                                                            },
                                                            "lastRow": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last row."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "sheet",
                                                            "firstRow",
                                                            "lastRow"
                                                          ],
                                                          "additionalProperties": false
                                                        },
                                                        {
                                                          "type": "object",
                                                          "properties": {
                                                            "kind": {
                                                              "type": "string",
                                                              "const": "lines",
                                                              "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                            },
                                                            "firstLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's first line."
                                                            },
                                                            "lastLine": {
                                                              "type": "integer",
                                                              "exclusiveMinimum": 0,
                                                              "maximum": 9007199254740991,
                                                              "description": "The part's last line."
                                                            }
                                                          },
                                                          "required": [
                                                            "kind",
                                                            "firstLine",
                                                            "lastLine"
                                                          ],
                                                          "additionalProperties": false
                                                        }
                                                      ],
                                                      "description": "Where in the file the part is."
                                                    }
                                                  },
                                                  "required": [
                                                    "documentId",
                                                    "revision",
                                                    "page",
                                                    "sha256",
                                                    "location"
                                                  ],
                                                  "additionalProperties": false,
                                                  "description": "The part of the document it was read from."
                                                }
                                              },
                                              "required": [
                                                "value",
                                                "source"
                                              ],
                                              "additionalProperties": false
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ],
                                          "description": "The currency Werk read in the document, or null when it found none."
                                        }
                                      },
                                      "required": [
                                        "issuer",
                                        "number",
                                        "date",
                                        "total",
                                        "currency"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                                },
                                "failureCode": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "parse_failed",
                                        "encrypted",
                                        "unsupported_format",
                                        "transcription_failed",
                                        "summary_failed",
                                        "invalid_output",
                                        "access_lost",
                                        "limit_exceeded",
                                        "provider_unavailable"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Why reading failed, or null."
                                },
                                "units": {
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                                },
                                "pages": {
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                                },
                                "sheets": {
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "A workbook's sheets with data; null for other files or when not known."
                                },
                                "removable": {
                                  "type": "boolean",
                                  "description": "True when the key's person may take this document off the card now."
                                }
                              },
                              "required": [
                                "id",
                                "itemId",
                                "filename",
                                "mimeType",
                                "revision",
                                "state",
                                "version",
                                "totalSources",
                                "readSources",
                                "truncated",
                                "summary",
                                "fields",
                                "failureCode",
                                "units",
                                "pages",
                                "sheets",
                                "removable"
                              ],
                              "additionalProperties": false,
                              "description": "The document, for a document."
                            }
                          },
                          "required": [
                            "kind",
                            "updateId",
                            "attachedBy",
                            "attachedAt",
                            "document"
                          ],
                          "additionalProperties": false
                        }
                      ],
                      "description": "The file."
                    }
                  },
                  "required": [
                    "file"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "file": {
                    "kind": "photo",
                    "updateId": "c9a3e7f1-4d6b-4f80-a2c8-5b1e9d3f7a46",
                    "photo": {
                      "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                      "attachedBy": {
                        "kind": "user",
                        "displayName": "Tom Okafor",
                        "initials": "TO",
                        "isViewer": false
                      },
                      "asset": {
                        "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                        "kind": "image",
                        "mimeType": "image/jpeg",
                        "sizeBytes": 482113,
                        "width": 1600,
                        "height": 1200
                      },
                      "attachedAt": "2026-11-19T16:12:00.000Z",
                      "removable": true
                    },
                    "reading": {
                      "state": "ready",
                      "description": "A chrome kitchen faucet with a cracked base, under a stainless sink.",
                      "text": null
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/documents/{documentId}/pages": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/documents/:documentId/pages",
        "tags": [
          "files"
        ],
        "summary": "Read a document's text",
        "description": "The text Werk read in a document, part by part.\n\nOnly a ready document has parts; any other answers its state with none. A cursor of an older revision answers cursor_expired.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "The document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          },
          {
            "name": "pageFrom",
            "in": "query",
            "required": false,
            "description": "The first part to read, counted from 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991
            }
          },
          {
            "name": "pageBefore",
            "in": "query",
            "required": false,
            "description": "The first part left out.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many parts a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "10"
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The parts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "type": "string",
                      "enum": [
                        "not_read",
                        "awaiting_confirmation",
                        "reading",
                        "failed",
                        "ready"
                      ],
                      "description": "The document's reading state."
                    },
                    "revision": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 9007199254740991,
                      "description": "The revision these parts were read in."
                    },
                    "pages": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "page": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 9007199254740991,
                            "description": "The part, counted from 1 in Werk's own count."
                          },
                          "location": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "pdf_page",
                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                  },
                                  "page": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The PDF page."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "page"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "section",
                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                  },
                                  "section": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The section, counted from 1."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "section"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "paragraph",
                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                  },
                                  "paragraph": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The paragraph, counted from 1."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "paragraph"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "sheet_rows",
                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                  },
                                  "sheet": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The sheet's name."
                                  },
                                  "firstRow": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The part's first row."
                                  },
                                  "lastRow": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The part's last row."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "sheet",
                                  "firstRow",
                                  "lastRow"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "lines",
                                    "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                  },
                                  "firstLine": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The part's first line."
                                  },
                                  "lastLine": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The part's last line."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "firstLine",
                                  "lastLine"
                                ],
                                "additionalProperties": false
                              }
                            ],
                            "description": "Where in the file the part is."
                          },
                          "text": {
                            "type": "string",
                            "description": "The text Werk read in the part."
                          }
                        },
                        "required": [
                          "page",
                          "location",
                          "text"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The parts Werk read, in order."
                    },
                    "nextCursor": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The cursor that reads the next page as after, or null when none remains."
                    }
                  },
                  "required": [
                    "state",
                    "revision",
                    "pages",
                    "nextCursor"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "state": "ready",
                  "revision": 1,
                  "pages": [
                    {
                      "page": 1,
                      "location": {
                        "kind": "pdf_page",
                        "page": 1
                      },
                      "text": "Stonecraft Supply. Quote Q-20931, November 17, 2026. Quartz countertop, 3 cm, polished edge."
                    }
                  ],
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/files/{fileId}/download-grants": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/files/:fileId/download-grants",
        "tags": [
          "files"
        ],
        "summary": "Get a download address",
        "description": "Makes an address that downloads one file of a card, valid an hour.\n\nThe address carries its own grant, so it needs no key; it stops working after the hour, or sooner when the key that asked for it ends or expires.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "fileId",
            "in": "path",
            "required": true,
            "description": "The photo's or the document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          }
        ],
        "responses": {
          "200": {
            "description": "The download address.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "path": {
                      "type": "string",
                      "minLength": 1,
                      "description": "The download address under the API's base; it carries its own grant, so it needs no key."
                    },
                    "expiresAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "description": "When the address stops working."
                    }
                  },
                  "required": [
                    "path",
                    "expiresAt"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "path": "/files/d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59/download/AQJ4c2VhbGVkLWdyYW50LWZvci10aGUtZmlsZQ",
                  "expiresAt": "2026-11-21T15:05:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/files/{fileId}/download/{grant}": {
      "get": {
        "operationId": "GET /api/v1/files/:fileId/download/:grant",
        "tags": [
          "files"
        ],
        "summary": "Download a file",
        "description": "The file's bytes, at an address made by its download grant.\n\nIt needs no key: the grant names who may read it. A document comes as an attachment; the file is read again for the person as it is now.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [],
        "security": [],
        "parameters": [
          {
            "name": "fileId",
            "in": "path",
            "required": true,
            "description": "The file's id, as the address names it.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          },
          {
            "name": "grant",
            "in": "path",
            "required": true,
            "description": "The grant, as the address names it.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "AQJ4c2VhbGVkLWdyYW50LWZvci10aGUtZmlsZQ"
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "The ETag of a copy already held. When it is current, the answer is 304.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file's bytes.",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "image/jpeg"
                }
              },
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/pdf"
                }
              },
              "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
                }
              },
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/csv"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/plain"
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/markdown"
                }
              }
            }
          },
          "304": {
            "description": "The copy held is current."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "download_grant_invalid",
              "item_not_found",
              "asset_not_found",
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "download_grant_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/cards/{cardId}": {
      "get": {
        "operationId": "GET /api/v1/cards/:cardId",
        "tags": [
          "cards"
        ],
        "summary": "Get a card by id",
        "description": "A card whole, found by its id in whichever of the key's person's projects holds it.\n\nThe same card as the project's own route gives, with its project's id beside it.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "photosLimit",
            "in": "query",
            "required": false,
            "description": "How many of the card's photos the answer holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "photosBefore",
            "in": "query",
            "required": false,
            "description": "The photos' nextCursor from an earlier answer, to read older photos.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "updatesLimit",
            "in": "query",
            "required": false,
            "description": "How many of the card's updates the answer holds.",
            "schema": {
              "default": 20,
              "type": "integer",
              "minimum": 1,
              "maximum": 50
            }
          },
          {
            "name": "updatesBefore",
            "in": "query",
            "required": false,
            "description": "The updates' nextCursor from an earlier answer, to read older updates.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "historyLimit",
            "in": "query",
            "required": false,
            "description": "How many history entries the answer holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "historyBefore",
            "in": "query",
            "required": false,
            "description": "The history's nextCursor from an earlier answer, to read older entries.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The card and its project.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "projectId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The card's project."
                    },
                    "conversationId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id Werk's apps use for the key's person's view of the project."
                    },
                    "item": {
                      "type": "object",
                      "properties": {
                        "followers": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "user",
                                    "description": "user for a person; connector or schedule for a change Werk made without one."
                                  },
                                  "displayName": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The person's name as the project shows it."
                                  },
                                  "initials": {
                                    "type": "string",
                                    "description": "The person's initials, for an avatar with no photo."
                                  },
                                  "isViewer": {
                                    "type": "boolean",
                                    "description": "True when the person is the key's own person."
                                  },
                                  "photo": {
                                    "type": "object",
                                    "properties": {
                                      "personId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The person whose photo it is."
                                      },
                                      "version": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                      }
                                    },
                                    "required": [
                                      "personId",
                                      "version"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The person's photo, when they have one."
                                  },
                                  "via": {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "enum": [
                                          "connection",
                                          "key"
                                        ],
                                        "description": "connection for an app connected by sign-in, key for an API key."
                                      },
                                      "name": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The app's or the key's name, as Werk shows it."
                                      },
                                      "verified": {
                                        "type": "boolean",
                                        "description": "True when Werk verified the app's identity."
                                      },
                                      "label": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The caption Werk shows beside the change, in the reader's language."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "name",
                                      "verified",
                                      "label"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "displayName",
                                  "initials",
                                  "isViewer"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "connector",
                                    "description": "user for a person; connector or schedule for a change Werk made without one."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The name Werk shows for a change made without a person."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "label"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "schedule",
                                    "description": "user for a person; connector or schedule for a change Werk made without one."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The name Werk shows for a change made without a person."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "label"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          },
                          "description": "The people who follow the card."
                        },
                        "following": {
                          "type": "boolean",
                          "description": "True when the key's person follows the card."
                        },
                        "checklist": {
                          "type": "object",
                          "properties": {
                            "revision": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                            },
                            "batches": {
                              "default": [],
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The set's id, which each of its items names as batch."
                                  },
                                  "itemId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The card's id."
                                  },
                                  "authorId": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The person who added the set, or null when no person did."
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                    "description": "When the set was added."
                                  },
                                  "groupId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The id of the change that added the set."
                                  }
                                },
                                "required": [
                                  "id",
                                  "itemId",
                                  "authorId",
                                  "createdAt",
                                  "groupId"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The sets of items added together in one change."
                            },
                            "items": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The item's id."
                                  },
                                  "position": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The item's place in the list, from 0."
                                  },
                                  "batch": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The id of the set the item was added in, or null when it was added on its own."
                                  },
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The item's text, as written."
                                  },
                                  "translation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The text in the reader's language, when it is written in another."
                                  },
                                  "checked": {
                                    "type": "boolean",
                                    "description": "True when the item is checked."
                                  },
                                  "checkedAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "When the item was checked, or null while it is not."
                                  },
                                  "checkedBy": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "user",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "displayName": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The person's name as the project shows it."
                                              },
                                              "initials": {
                                                "type": "string",
                                                "description": "The person's initials, for an avatar with no photo."
                                              },
                                              "isViewer": {
                                                "type": "boolean",
                                                "description": "True when the person is the key's own person."
                                              },
                                              "photo": {
                                                "type": "object",
                                                "properties": {
                                                  "personId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person whose photo it is."
                                                  },
                                                  "version": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                  }
                                                },
                                                "required": [
                                                  "personId",
                                                  "version"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The person's photo, when they have one."
                                              },
                                              "via": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "connection",
                                                      "key"
                                                    ],
                                                    "description": "connection for an app connected by sign-in, key for an API key."
                                                  },
                                                  "name": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The app's or the key's name, as Werk shows it."
                                                  },
                                                  "verified": {
                                                    "type": "boolean",
                                                    "description": "True when Werk verified the app's identity."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "name",
                                                  "verified",
                                                  "label"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "displayName",
                                              "initials",
                                              "isViewer"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "connector",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "schedule",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who checked the item, or null while it is not checked."
                                  }
                                },
                                "required": [
                                  "id",
                                  "position",
                                  "batch",
                                  "text",
                                  "checked",
                                  "checkedAt",
                                  "checkedBy"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The list's items, in their order."
                            },
                            "counts": {
                              "type": "object",
                              "properties": {
                                "done": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items checked."
                                },
                                "total": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "List items in all."
                                }
                              },
                              "required": [
                                "done",
                                "total"
                              ],
                              "additionalProperties": false,
                              "description": "The list's items checked and in all."
                            }
                          },
                          "required": [
                            "batches",
                            "items",
                            "counts"
                          ],
                          "additionalProperties": false,
                          "description": "The card's list of items to check off."
                        },
                        "reminders": {
                          "type": "object",
                          "properties": {
                            "reminders": {
                              "maxItems": 3,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The reminder's id."
                                  },
                                  "itemId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The card the reminder is on."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                                  },
                                  "timeRevision": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                                  },
                                  "snoozeRevision": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                                  },
                                  "fireAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The time its owner set the reminder for."
                                  },
                                  "effectiveFireAt": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                                  },
                                  "snoozedUntil": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "format": "date-time",
                                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The time the key's person snoozed the reminder to, or null."
                                  },
                                  "setterTimeZone": {
                                    "type": "string",
                                    "description": "The time zone the reminder's time was set in."
                                  },
                                  "text": {
                                    "type": [
                                      "string",
                                      "null"
                                    ],
                                    "description": "The reminder's text, as its owner wrote it."
                                  },
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The language a shared reminder's text is written in."
                                  },
                                  "translation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A shared reminder's text in the reader's language, when it is written in another."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "upcoming",
                                      "past",
                                      "dropped"
                                    ],
                                    "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                                  },
                                  "audience": {
                                    "type": "object",
                                    "properties": {
                                      "kind": {
                                        "type": "string",
                                        "enum": [
                                          "only_you",
                                          "invited_by_you",
                                          "from_owner"
                                        ],
                                        "description": "only_you for the key's person's own reminder shared with nobody, invited_by_you for their own reminder shared with others, from_owner for a reminder someone shared with them."
                                      },
                                      "label": {
                                        "type": "string",
                                        "description": "Who the reminder is for, in one line in the reader's language."
                                      },
                                      "owner": {
                                        "type": "object",
                                        "properties": {
                                          "userId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person's id."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          }
                                        },
                                        "required": [
                                          "userId",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The person who set the reminder."
                                      },
                                      "invited": {
                                        "type": "array",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "userId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person's id."
                                            },
                                            "displayName": {
                                              "type": "string",
                                              "description": "The person's name as the project shows it."
                                            },
                                            "initials": {
                                              "type": "string",
                                              "description": "The person's initials, for an avatar with no photo."
                                            },
                                            "isViewer": {
                                              "type": "boolean",
                                              "description": "True when the person is the key's own person."
                                            },
                                            "photo": {
                                              "type": "object",
                                              "properties": {
                                                "personId": {
                                                  "type": "string",
                                                  "format": "uuid",
                                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                  "description": "The person whose photo it is."
                                                },
                                                "version": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                }
                                              },
                                              "required": [
                                                "personId",
                                                "version"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The person's photo, when they have one."
                                            }
                                          },
                                          "required": [
                                            "userId",
                                            "displayName",
                                            "initials",
                                            "isViewer"
                                          ],
                                          "additionalProperties": false
                                        },
                                        "description": "The people the owner shared the reminder with who accepted it."
                                      }
                                    },
                                    "required": [
                                      "kind",
                                      "label",
                                      "owner",
                                      "invited"
                                    ],
                                    "additionalProperties": false,
                                    "description": "Whose reminder it is and who it is shared with."
                                  },
                                  "quotedReminderRef": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The reminder's id."
                                          },
                                          "expectedVersion": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The reminder's version as last read."
                                          }
                                        },
                                        "required": [
                                          "id",
                                          "expectedVersion"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The reminder's id and version as Werk's apps quote it in a chat message; null on a reminder shared by someone else."
                                  },
                                  "actions": {
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "enum": [
                                        "delete",
                                        "remove",
                                        "snooze_hour",
                                        "snooze_tomorrow",
                                        "invite_in_chat"
                                      ]
                                    },
                                    "description": "What the key's person may do with the reminder now: delete their own, remove a shared one from their list, snooze it, share it."
                                  }
                                },
                                "required": [
                                  "id",
                                  "itemId",
                                  "version",
                                  "timeRevision",
                                  "snoozeRevision",
                                  "fireAt",
                                  "effectiveFireAt",
                                  "snoozedUntil",
                                  "setterTimeZone",
                                  "text",
                                  "state",
                                  "audience",
                                  "quotedReminderRef",
                                  "actions"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The next three upcoming reminders, soonest first."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many reminders there are in all, past and dropped ones included."
                            }
                          },
                          "required": [
                            "reminders",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The reminders the key's person sees on this card: the first three and how many in all."
                        },
                        "documents": {
                          "type": "object",
                          "properties": {
                            "documents": {
                              "maxItems": 3,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The document's id."
                                  },
                                  "itemId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The card the document is on."
                                  },
                                  "filename": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 255,
                                    "description": "The document's name."
                                  },
                                  "mimeType": {
                                    "type": "string",
                                    "enum": [
                                      "application/pdf",
                                      "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                      "text/csv",
                                      "text/plain",
                                      "text/markdown"
                                    ],
                                    "description": "The document's media type."
                                  },
                                  "revision": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The document's revision, which grows each time its file is replaced."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "not_read",
                                      "awaiting_confirmation",
                                      "reading",
                                      "failed",
                                      "ready"
                                    ],
                                    "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                                  },
                                  "totalSources": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "How many parts the document has, or null while not known."
                                  },
                                  "readSources": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "How many parts Werk read."
                                  },
                                  "truncated": {
                                    "type": "boolean",
                                    "description": "True when Werk read only the document's first parts."
                                  },
                                  "summary": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 2000
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Werk's summary of the document, or null."
                                  },
                                  "fields": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "issuer": {
                                            "anyOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "maxLength": 512,
                                                    "description": "The issuer as read."
                                                  },
                                                  "source": {
                                                    "type": "object",
                                                    "properties": {
                                                      "documentId": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The document's id."
                                                      },
                                                      "revision": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The revision it was read in."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                      },
                                                      "sha256": {
                                                        "type": "string",
                                                        "pattern": "^[a-f0-9]{64}$",
                                                        "description": "The SHA-256 of the file it was read from."
                                                      },
                                                      "location": {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "pdf_page",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "page": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The PDF page."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "page"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "section",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "section": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The section, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "section"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "paragraph",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "paragraph": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The paragraph, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "paragraph"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "sheet_rows",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "sheet": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The sheet's name."
                                                              },
                                                              "firstRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first row."
                                                              },
                                                              "lastRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last row."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "sheet",
                                                              "firstRow",
                                                              "lastRow"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "lines",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "firstLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first line."
                                                              },
                                                              "lastLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last line."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "firstLine",
                                                              "lastLine"
                                                            ],
                                                            "additionalProperties": false
                                                          }
                                                        ],
                                                        "description": "Where in the file the part is."
                                                      }
                                                    },
                                                    "required": [
                                                      "documentId",
                                                      "revision",
                                                      "page",
                                                      "sha256",
                                                      "location"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The part of the document it was read from."
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "source"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ],
                                            "description": "The issuer Werk read in the document, or null when it found none."
                                          },
                                          "number": {
                                            "anyOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "maxLength": 128,
                                                    "description": "The document's number as read."
                                                  },
                                                  "source": {
                                                    "type": "object",
                                                    "properties": {
                                                      "documentId": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The document's id."
                                                      },
                                                      "revision": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The revision it was read in."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                      },
                                                      "sha256": {
                                                        "type": "string",
                                                        "pattern": "^[a-f0-9]{64}$",
                                                        "description": "The SHA-256 of the file it was read from."
                                                      },
                                                      "location": {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "pdf_page",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "page": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The PDF page."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "page"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "section",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "section": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The section, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "section"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "paragraph",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "paragraph": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The paragraph, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "paragraph"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "sheet_rows",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "sheet": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The sheet's name."
                                                              },
                                                              "firstRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first row."
                                                              },
                                                              "lastRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last row."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "sheet",
                                                              "firstRow",
                                                              "lastRow"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "lines",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "firstLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first line."
                                                              },
                                                              "lastLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last line."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "firstLine",
                                                              "lastLine"
                                                            ],
                                                            "additionalProperties": false
                                                          }
                                                        ],
                                                        "description": "Where in the file the part is."
                                                      }
                                                    },
                                                    "required": [
                                                      "documentId",
                                                      "revision",
                                                      "page",
                                                      "sha256",
                                                      "location"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The part of the document it was read from."
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "source"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ],
                                            "description": "The document's number Werk read in the document, or null when it found none."
                                          },
                                          "date": {
                                            "anyOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string",
                                                    "format": "date",
                                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                                    "description": "The date as read, as YYYY-MM-DD."
                                                  },
                                                  "source": {
                                                    "type": "object",
                                                    "properties": {
                                                      "documentId": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The document's id."
                                                      },
                                                      "revision": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The revision it was read in."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                      },
                                                      "sha256": {
                                                        "type": "string",
                                                        "pattern": "^[a-f0-9]{64}$",
                                                        "description": "The SHA-256 of the file it was read from."
                                                      },
                                                      "location": {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "pdf_page",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "page": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The PDF page."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "page"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "section",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "section": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The section, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "section"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "paragraph",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "paragraph": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The paragraph, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "paragraph"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "sheet_rows",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "sheet": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The sheet's name."
                                                              },
                                                              "firstRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first row."
                                                              },
                                                              "lastRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last row."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "sheet",
                                                              "firstRow",
                                                              "lastRow"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "lines",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "firstLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first line."
                                                              },
                                                              "lastLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last line."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "firstLine",
                                                              "lastLine"
                                                            ],
                                                            "additionalProperties": false
                                                          }
                                                        ],
                                                        "description": "Where in the file the part is."
                                                      }
                                                    },
                                                    "required": [
                                                      "documentId",
                                                      "revision",
                                                      "page",
                                                      "sha256",
                                                      "location"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The part of the document it was read from."
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "source"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ],
                                            "description": "The date Werk read in the document, or null when it found none."
                                          },
                                          "total": {
                                            "anyOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string",
                                                    "maxLength": 128,
                                                    "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                                    "description": "The total as read, a decimal number with a point."
                                                  },
                                                  "source": {
                                                    "type": "object",
                                                    "properties": {
                                                      "documentId": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The document's id."
                                                      },
                                                      "revision": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The revision it was read in."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                      },
                                                      "sha256": {
                                                        "type": "string",
                                                        "pattern": "^[a-f0-9]{64}$",
                                                        "description": "The SHA-256 of the file it was read from."
                                                      },
                                                      "location": {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "pdf_page",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "page": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The PDF page."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "page"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "section",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "section": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The section, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "section"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "paragraph",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "paragraph": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The paragraph, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "paragraph"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "sheet_rows",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "sheet": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The sheet's name."
                                                              },
                                                              "firstRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first row."
                                                              },
                                                              "lastRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last row."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "sheet",
                                                              "firstRow",
                                                              "lastRow"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "lines",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "firstLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first line."
                                                              },
                                                              "lastLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last line."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "firstLine",
                                                              "lastLine"
                                                            ],
                                                            "additionalProperties": false
                                                          }
                                                        ],
                                                        "description": "Where in the file the part is."
                                                      }
                                                    },
                                                    "required": [
                                                      "documentId",
                                                      "revision",
                                                      "page",
                                                      "sha256",
                                                      "location"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The part of the document it was read from."
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "source"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ],
                                            "description": "The total Werk read in the document, or null when it found none."
                                          },
                                          "currency": {
                                            "anyOf": [
                                              {
                                                "type": "object",
                                                "properties": {
                                                  "value": {
                                                    "type": "string",
                                                    "pattern": "^[A-Z]{3}$",
                                                    "description": "The currency as read, its ISO 4217 code."
                                                  },
                                                  "source": {
                                                    "type": "object",
                                                    "properties": {
                                                      "documentId": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The document's id."
                                                      },
                                                      "revision": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The revision it was read in."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                      },
                                                      "sha256": {
                                                        "type": "string",
                                                        "pattern": "^[a-f0-9]{64}$",
                                                        "description": "The SHA-256 of the file it was read from."
                                                      },
                                                      "location": {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "pdf_page",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "page": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The PDF page."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "page"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "section",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "section": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The section, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "section"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "paragraph",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "paragraph": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The paragraph, counted from 1."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "paragraph"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "sheet_rows",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "sheet": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The sheet's name."
                                                              },
                                                              "firstRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first row."
                                                              },
                                                              "lastRow": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last row."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "sheet",
                                                              "firstRow",
                                                              "lastRow"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "lines",
                                                                "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                              },
                                                              "firstLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's first line."
                                                              },
                                                              "lastLine": {
                                                                "type": "integer",
                                                                "exclusiveMinimum": 0,
                                                                "maximum": 9007199254740991,
                                                                "description": "The part's last line."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "firstLine",
                                                              "lastLine"
                                                            ],
                                                            "additionalProperties": false
                                                          }
                                                        ],
                                                        "description": "Where in the file the part is."
                                                      }
                                                    },
                                                    "required": [
                                                      "documentId",
                                                      "revision",
                                                      "page",
                                                      "sha256",
                                                      "location"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The part of the document it was read from."
                                                  }
                                                },
                                                "required": [
                                                  "value",
                                                  "source"
                                                ],
                                                "additionalProperties": false
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ],
                                            "description": "The currency Werk read in the document, or null when it found none."
                                          }
                                        },
                                        "required": [
                                          "issuer",
                                          "number",
                                          "date",
                                          "total",
                                          "currency"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                                  },
                                  "failureCode": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "parse_failed",
                                          "encrypted",
                                          "unsupported_format",
                                          "transcription_failed",
                                          "summary_failed",
                                          "invalid_output",
                                          "access_lost",
                                          "limit_exceeded",
                                          "provider_unavailable"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Why reading failed, or null."
                                  },
                                  "units": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                                  },
                                  "pages": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                                  },
                                  "sheets": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "A workbook's sheets with data; null for other files or when not known."
                                  },
                                  "removable": {
                                    "type": "boolean",
                                    "description": "True when the key's person may take this document off the card now."
                                  }
                                },
                                "required": [
                                  "id",
                                  "itemId",
                                  "filename",
                                  "mimeType",
                                  "revision",
                                  "state",
                                  "version",
                                  "totalSources",
                                  "readSources",
                                  "truncated",
                                  "summary",
                                  "fields",
                                  "failureCode",
                                  "units",
                                  "pages",
                                  "sheets",
                                  "removable"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The card's first three documents."
                            },
                            "hasMore": {
                              "type": "boolean",
                              "description": "True when the card has more documents."
                            }
                          },
                          "required": [
                            "documents",
                            "hasMore"
                          ],
                          "additionalProperties": false,
                          "description": "The documents on the card."
                        },
                        "item": {
                          "type": "object",
                          "properties": {
                            "outcome": {
                              "type": "string",
                              "enum": [
                                "open",
                                "completed",
                                "not_completed"
                              ],
                              "description": "completed when the card is on its project's last step, not_completed when it was archived before it, open otherwise."
                            },
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card's id."
                            },
                            "ref": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The card's number as people write it, with # before it."
                            },
                            "title": {
                              "type": "string",
                              "description": "The card's title, as written."
                            },
                            "language": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "description": "The language the card's title and description are written in."
                            },
                            "titleTranslation": {
                              "type": "object",
                              "properties": {
                                "language": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The reader's language the text is translated into."
                                },
                                "state": {
                                  "type": "string",
                                  "enum": [
                                    "ready",
                                    "pending",
                                    "failed",
                                    "paused"
                                  ],
                                  "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                },
                                "text": {
                                  "type": "string",
                                  "description": "The translated text, present once ready."
                                }
                              },
                              "required": [
                                "language",
                                "state"
                              ],
                              "additionalProperties": false,
                              "description": "The title in the reader's language, when it is written in another."
                            },
                            "status": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The id of the step the card is on."
                                },
                                "label": {
                                  "type": "string",
                                  "minLength": 1,
                                  "description": "The step's name."
                                },
                                "category": {
                                  "type": "string",
                                  "enum": [
                                    "open",
                                    "active",
                                    "done"
                                  ],
                                  "description": "open on a new step, done on the project's last step, active on any other step."
                                },
                                "bucket": {
                                  "type": "string",
                                  "enum": [
                                    "new",
                                    "in_progress",
                                    "waiting",
                                    "resolved",
                                    "closed"
                                  ],
                                  "description": "The kind of step the card is on; a step that ends the work reads in_progress while it is not the project's last step."
                                },
                                "labelLanguage": {
                                  "type": "string",
                                  "minLength": 2,
                                  "maxLength": 64,
                                  "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                },
                                "labelTranslation": {
                                  "type": "object",
                                  "properties": {
                                    "language": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The reader's language the text is translated into."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "ready",
                                        "pending",
                                        "failed",
                                        "paused"
                                      ],
                                      "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                    },
                                    "text": {
                                      "type": "string",
                                      "description": "The translated text, present once ready."
                                    }
                                  },
                                  "required": [
                                    "language",
                                    "state"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The step's name in the reader's language, when it is written in another."
                                }
                              },
                              "required": [
                                "key",
                                "label",
                                "category"
                              ],
                              "additionalProperties": false,
                              "description": "The step the card is on, with where that step sits in the work."
                            },
                            "dueNoticeLead": {
                              "type": "string",
                              "enum": [
                                "none",
                                "at_due",
                                "15_minutes",
                                "1_hour",
                                "2_hours",
                                "1_day",
                                "2_days"
                              ],
                              "description": "How long before the due date its holder and followers get the due notice; none sends no notice."
                            },
                            "dueSetBy": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "displayName": {
                                      "type": "string",
                                      "description": "That person's name."
                                    }
                                  },
                                  "required": [
                                    "displayName"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Who set the due moment; present only for a due date with a time."
                            },
                            "due": {
                              "anyOf": [
                                {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "date",
                                          "description": "date for a due day with no time, datetime for a due moment."
                                        },
                                        "date": {
                                          "type": "string",
                                          "format": "date",
                                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                          "description": "The due day, as YYYY-MM-DD."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "date"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "datetime",
                                          "description": "date for a due day with no time, datetime for a due moment."
                                        },
                                        "at": {
                                          "type": "string",
                                          "format": "date-time",
                                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                          "description": "The due moment, as an ISO 8601 date and time with its offset."
                                        },
                                        "enteredTimeZone": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The time zone the due moment was given in, when known."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "at"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The card's due date, or null when it has none."
                            },
                            "assignee": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "personId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The holder's person id."
                                    },
                                    "displayName": {
                                      "type": "string",
                                      "description": "The holder's name as the project shows it."
                                    },
                                    "initials": {
                                      "type": "string",
                                      "description": "The holder's initials, for an avatar with no photo."
                                    },
                                    "photo": {
                                      "type": "object",
                                      "properties": {
                                        "personId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The person whose photo it is."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                        }
                                      },
                                      "required": [
                                        "personId",
                                        "version"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The holder's photo, when they have one."
                                    }
                                  },
                                  "required": [
                                    "displayName"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The card's holder, or null when the card is free."
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 9007199254740991,
                              "description": "The card's version, which grows with every change to it."
                            },
                            "number": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The card's number in its project, unique there and never reused."
                            },
                            "currentStep": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The step's id; a change of step sends it as stepId."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The step's name."
                                    },
                                    "bucket": {
                                      "type": "string",
                                      "enum": [
                                        "new",
                                        "in_progress",
                                        "waiting",
                                        "resolved",
                                        "closed"
                                      ],
                                      "description": "The kind of step: new for an open step, in_progress or waiting for one in between, resolved or closed for one that ends the work."
                                    },
                                    "labelLanguage": {
                                      "type": "string",
                                      "minLength": 2,
                                      "maxLength": 64,
                                      "description": "The language the step's name is written in; absent for a step name Werk writes in the reader's language itself."
                                    },
                                    "labelTranslation": {
                                      "type": "object",
                                      "properties": {
                                        "language": {
                                          "type": "string",
                                          "minLength": 2,
                                          "maxLength": 64,
                                          "description": "The reader's language the text is translated into."
                                        },
                                        "state": {
                                          "type": "string",
                                          "enum": [
                                            "ready",
                                            "pending",
                                            "failed",
                                            "paused"
                                          ],
                                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                        },
                                        "text": {
                                          "type": "string",
                                          "description": "The translated text, present once ready."
                                        }
                                      },
                                      "required": [
                                        "language",
                                        "state"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The step's name in the reader's language, when it is written in another."
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "label",
                                    "bucket"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The card's step among its project's steps, as the project defines it."
                            },
                            "archived": {
                              "type": "boolean",
                              "description": "True when the card is archived: it has left the working lists and stays readable and searchable."
                            },
                            "counts": {
                              "type": "object",
                              "properties": {
                                "photos": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "Photos on the card."
                                },
                                "updates": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "Updates on the card."
                                },
                                "documents": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "Documents on the card."
                                },
                                "checklist": {
                                  "type": "object",
                                  "properties": {
                                    "done": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "List items checked."
                                    },
                                    "total": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "List items in all."
                                    }
                                  },
                                  "required": [
                                    "done",
                                    "total"
                                  ],
                                  "additionalProperties": false,
                                  "description": "The card's list: its items checked and in all; absent when the card has no list."
                                }
                              },
                              "required": [
                                "photos",
                                "updates",
                                "documents"
                              ],
                              "additionalProperties": false,
                              "description": "How much the card holds."
                            },
                            "allowedActions": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "enum": [
                                  "take_card",
                                  "assign_card",
                                  "give_back_card",
                                  "move_card",
                                  "archive_card",
                                  "unarchive_card",
                                  "edit_card",
                                  "set_card_due",
                                  "add_update",
                                  "create_reminder",
                                  "link_duplicate",
                                  "add_entries",
                                  "rename_entry",
                                  "remove_entry",
                                  "reorder_entries",
                                  "follow_card",
                                  "unfollow_card",
                                  "follow_invitation",
                                  "tick_entry",
                                  "untick_entry",
                                  "set_due_notice"
                                ]
                              },
                              "description": "The changes the key's person may make to this card by hand now, by action name."
                            }
                          },
                          "required": [
                            "id",
                            "ref",
                            "title",
                            "status",
                            "due",
                            "assignee",
                            "version"
                          ],
                          "additionalProperties": false,
                          "description": "The card."
                        },
                        "description": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The card's description, or null when it has none."
                        },
                        "descriptionTranslation": {
                          "type": "object",
                          "properties": {
                            "language": {
                              "type": "string",
                              "minLength": 2,
                              "maxLength": 64,
                              "description": "The reader's language the text is translated into."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "ready",
                                "pending",
                                "failed",
                                "paused"
                              ],
                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                            },
                            "text": {
                              "type": "string",
                              "description": "The translated text, present once ready."
                            }
                          },
                          "required": [
                            "language",
                            "state"
                          ],
                          "additionalProperties": false,
                          "description": "The description in the reader's language, when it is written in another."
                        },
                        "author": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "user",
                                      "description": "user for a person; connector or schedule for a change Werk made without one."
                                    },
                                    "displayName": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The person's name as the project shows it."
                                    },
                                    "initials": {
                                      "type": "string",
                                      "description": "The person's initials, for an avatar with no photo."
                                    },
                                    "isViewer": {
                                      "type": "boolean",
                                      "description": "True when the person is the key's own person."
                                    },
                                    "photo": {
                                      "type": "object",
                                      "properties": {
                                        "personId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The person whose photo it is."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                        }
                                      },
                                      "required": [
                                        "personId",
                                        "version"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The person's photo, when they have one."
                                    },
                                    "via": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "connection",
                                            "key"
                                          ],
                                          "description": "connection for an app connected by sign-in, key for an API key."
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The app's or the key's name, as Werk shows it."
                                        },
                                        "verified": {
                                          "type": "boolean",
                                          "description": "True when Werk verified the app's identity."
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The caption Werk shows beside the change, in the reader's language."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "name",
                                        "verified",
                                        "label"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "displayName",
                                    "initials",
                                    "isViewer"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "connector",
                                      "description": "user for a person; connector or schedule for a change Werk made without one."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The name Werk shows for a change made without a person."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "label"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "schedule",
                                      "description": "user for a person; connector or schedule for a change Werk made without one."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The name Werk shows for a change made without a person."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "label"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who created the card, or null when no longer known."
                        },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the card was created."
                        },
                        "assignedBy": {
                          "anyOf": [
                            {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "user",
                                      "description": "user for a person; connector or schedule for a change Werk made without one."
                                    },
                                    "displayName": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The person's name as the project shows it."
                                    },
                                    "initials": {
                                      "type": "string",
                                      "description": "The person's initials, for an avatar with no photo."
                                    },
                                    "isViewer": {
                                      "type": "boolean",
                                      "description": "True when the person is the key's own person."
                                    },
                                    "photo": {
                                      "type": "object",
                                      "properties": {
                                        "personId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The person whose photo it is."
                                        },
                                        "version": {
                                          "type": "integer",
                                          "exclusiveMinimum": 0,
                                          "maximum": 9007199254740991,
                                          "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                        }
                                      },
                                      "required": [
                                        "personId",
                                        "version"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The person's photo, when they have one."
                                    },
                                    "via": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "connection",
                                            "key"
                                          ],
                                          "description": "connection for an app connected by sign-in, key for an API key."
                                        },
                                        "name": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The app's or the key's name, as Werk shows it."
                                        },
                                        "verified": {
                                          "type": "boolean",
                                          "description": "True when Werk verified the app's identity."
                                        },
                                        "label": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The caption Werk shows beside the change, in the reader's language."
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "name",
                                        "verified",
                                        "label"
                                      ],
                                      "additionalProperties": false,
                                      "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "displayName",
                                    "initials",
                                    "isViewer"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "connector",
                                      "description": "user for a person; connector or schedule for a change Werk made without one."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The name Werk shows for a change made without a person."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "label"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "schedule",
                                      "description": "user for a person; connector or schedule for a change Werk made without one."
                                    },
                                    "label": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The name Werk shows for a change made without a person."
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "label"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Who gave the card to its current holder, or null when that is not known."
                        },
                        "photos": {
                          "type": "object",
                          "properties": {
                            "entries": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The photo's id on the card; removing it names this id."
                                  },
                                  "attachedBy": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "user",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "displayName": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The person's name as the project shows it."
                                              },
                                              "initials": {
                                                "type": "string",
                                                "description": "The person's initials, for an avatar with no photo."
                                              },
                                              "isViewer": {
                                                "type": "boolean",
                                                "description": "True when the person is the key's own person."
                                              },
                                              "photo": {
                                                "type": "object",
                                                "properties": {
                                                  "personId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person whose photo it is."
                                                  },
                                                  "version": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                  }
                                                },
                                                "required": [
                                                  "personId",
                                                  "version"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The person's photo, when they have one."
                                              },
                                              "via": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "connection",
                                                      "key"
                                                    ],
                                                    "description": "connection for an app connected by sign-in, key for an API key."
                                                  },
                                                  "name": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The app's or the key's name, as Werk shows it."
                                                  },
                                                  "verified": {
                                                    "type": "boolean",
                                                    "description": "True when Werk verified the app's identity."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "name",
                                                  "verified",
                                                  "label"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "displayName",
                                              "initials",
                                              "isViewer"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "connector",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "schedule",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who added the photo, or null when no longer known."
                                  },
                                  "asset": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The file's id."
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "image",
                                        "description": "What the file is: a photo, a voice recording or a document."
                                      },
                                      "filename": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 255,
                                        "description": "The document's name; only a document has one."
                                      },
                                      "format": {
                                        "type": "string",
                                        "enum": [
                                          "pdf",
                                          "docx",
                                          "xlsx",
                                          "csv",
                                          "txt",
                                          "md"
                                        ],
                                        "description": "The document's format; only a document has one."
                                      },
                                      "mimeType": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The file's media type."
                                      },
                                      "sizeBytes": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The file's size in bytes."
                                      },
                                      "width": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                                      },
                                      "height": {
                                        "type": "integer",
                                        "exclusiveMinimum": 0,
                                        "maximum": 9007199254740991,
                                        "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                                      },
                                      "durationSeconds": {
                                        "type": "number",
                                        "exclusiveMinimum": 0,
                                        "maximum": 300,
                                        "description": "The recording's length in seconds; only a voice recording has one."
                                      },
                                      "available": {
                                        "type": "boolean",
                                        "description": "False once the file's bytes were released and it can no longer be read."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "mimeType",
                                      "sizeBytes"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The photo's file."
                                  },
                                  "attachedAt": {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                    "description": "When the photo was added to the card."
                                  },
                                  "removable": {
                                    "type": "boolean",
                                    "description": "True when the key's person may take this photo off the card now."
                                  }
                                },
                                "required": [
                                  "id",
                                  "attachedBy",
                                  "asset",
                                  "attachedAt",
                                  "removable"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The photos on this page, newest first."
                            },
                            "hasMore": {
                              "type": "boolean",
                              "description": "True when older photos remain past this page."
                            },
                            "nextCursor": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 512
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The cursor that reads the next page, or null when none remains."
                            }
                          },
                          "required": [
                            "entries",
                            "hasMore",
                            "nextCursor"
                          ],
                          "additionalProperties": false,
                          "description": "The card's photos, newest first, one page."
                        },
                        "updates": {
                          "type": "object",
                          "properties": {
                            "entries": {
                              "maxItems": 50,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The update's id."
                                  },
                                  "author": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "user",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "displayName": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The person's name as the project shows it."
                                              },
                                              "initials": {
                                                "type": "string",
                                                "description": "The person's initials, for an avatar with no photo."
                                              },
                                              "isViewer": {
                                                "type": "boolean",
                                                "description": "True when the person is the key's own person."
                                              },
                                              "photo": {
                                                "type": "object",
                                                "properties": {
                                                  "personId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person whose photo it is."
                                                  },
                                                  "version": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                  }
                                                },
                                                "required": [
                                                  "personId",
                                                  "version"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The person's photo, when they have one."
                                              },
                                              "via": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "connection",
                                                      "key"
                                                    ],
                                                    "description": "connection for an app connected by sign-in, key for an API key."
                                                  },
                                                  "name": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The app's or the key's name, as Werk shows it."
                                                  },
                                                  "verified": {
                                                    "type": "boolean",
                                                    "description": "True when Werk verified the app's identity."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "name",
                                                  "verified",
                                                  "label"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "displayName",
                                              "initials",
                                              "isViewer"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "connector",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "schedule",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who wrote the update, or null when no longer known."
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                    "description": "When the update was written."
                                  },
                                  "entries": {
                                    "minItems": 1,
                                    "maxItems": 50,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "id": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The entry's id."
                                        },
                                        "photos": {
                                          "type": "object",
                                          "properties": {
                                            "entries": {
                                              "maxItems": 10,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "id": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The photo's id on the card; removing it names this id."
                                                  },
                                                  "attachedBy": {
                                                    "anyOf": [
                                                      {
                                                        "oneOf": [
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "user",
                                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                                              },
                                                              "displayName": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The person's name as the project shows it."
                                                              },
                                                              "initials": {
                                                                "type": "string",
                                                                "description": "The person's initials, for an avatar with no photo."
                                                              },
                                                              "isViewer": {
                                                                "type": "boolean",
                                                                "description": "True when the person is the key's own person."
                                                              },
                                                              "photo": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "personId": {
                                                                    "type": "string",
                                                                    "format": "uuid",
                                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                                    "description": "The person whose photo it is."
                                                                  },
                                                                  "version": {
                                                                    "type": "integer",
                                                                    "exclusiveMinimum": 0,
                                                                    "maximum": 9007199254740991,
                                                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "personId",
                                                                  "version"
                                                                ],
                                                                "additionalProperties": false,
                                                                "description": "The person's photo, when they have one."
                                                              },
                                                              "via": {
                                                                "type": "object",
                                                                "properties": {
                                                                  "kind": {
                                                                    "type": "string",
                                                                    "enum": [
                                                                      "connection",
                                                                      "key"
                                                                    ],
                                                                    "description": "connection for an app connected by sign-in, key for an API key."
                                                                  },
                                                                  "name": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The app's or the key's name, as Werk shows it."
                                                                  },
                                                                  "verified": {
                                                                    "type": "boolean",
                                                                    "description": "True when Werk verified the app's identity."
                                                                  },
                                                                  "label": {
                                                                    "type": "string",
                                                                    "minLength": 1,
                                                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                                                  }
                                                                },
                                                                "required": [
                                                                  "kind",
                                                                  "name",
                                                                  "verified",
                                                                  "label"
                                                                ],
                                                                "additionalProperties": false,
                                                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "displayName",
                                                              "initials",
                                                              "isViewer"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "connector",
                                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                                              },
                                                              "label": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The name Werk shows for a change made without a person."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "label"
                                                            ],
                                                            "additionalProperties": false
                                                          },
                                                          {
                                                            "type": "object",
                                                            "properties": {
                                                              "kind": {
                                                                "type": "string",
                                                                "const": "schedule",
                                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                                              },
                                                              "label": {
                                                                "type": "string",
                                                                "minLength": 1,
                                                                "description": "The name Werk shows for a change made without a person."
                                                              }
                                                            },
                                                            "required": [
                                                              "kind",
                                                              "label"
                                                            ],
                                                            "additionalProperties": false
                                                          }
                                                        ]
                                                      },
                                                      {
                                                        "type": "null"
                                                      }
                                                    ],
                                                    "description": "Who added the photo, or null when no longer known."
                                                  },
                                                  "asset": {
                                                    "type": "object",
                                                    "properties": {
                                                      "id": {
                                                        "type": "string",
                                                        "format": "uuid",
                                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                        "description": "The file's id."
                                                      },
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "image",
                                                        "description": "What the file is: a photo, a voice recording or a document."
                                                      },
                                                      "filename": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "maxLength": 255,
                                                        "description": "The document's name; only a document has one."
                                                      },
                                                      "format": {
                                                        "type": "string",
                                                        "enum": [
                                                          "pdf",
                                                          "docx",
                                                          "xlsx",
                                                          "csv",
                                                          "txt",
                                                          "md"
                                                        ],
                                                        "description": "The document's format; only a document has one."
                                                      },
                                                      "mimeType": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The file's media type."
                                                      },
                                                      "sizeBytes": {
                                                        "type": "integer",
                                                        "minimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The file's size in bytes."
                                                      },
                                                      "width": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                                                      },
                                                      "height": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                                                      },
                                                      "durationSeconds": {
                                                        "type": "number",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 300,
                                                        "description": "The recording's length in seconds; only a voice recording has one."
                                                      },
                                                      "available": {
                                                        "type": "boolean",
                                                        "description": "False once the file's bytes were released and it can no longer be read."
                                                      }
                                                    },
                                                    "required": [
                                                      "id",
                                                      "kind",
                                                      "mimeType",
                                                      "sizeBytes"
                                                    ],
                                                    "additionalProperties": false,
                                                    "description": "The photo's file."
                                                  },
                                                  "attachedAt": {
                                                    "type": "string",
                                                    "format": "date-time",
                                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                                    "description": "When the photo was added to the card."
                                                  },
                                                  "removable": {
                                                    "type": "boolean",
                                                    "description": "True when the key's person may take this photo off the card now."
                                                  }
                                                },
                                                "required": [
                                                  "id",
                                                  "attachedBy",
                                                  "asset",
                                                  "attachedAt",
                                                  "removable"
                                                ],
                                                "additionalProperties": false
                                              },
                                              "description": "The photos on this page, newest first."
                                            },
                                            "hasMore": {
                                              "type": "boolean",
                                              "description": "True when older photos remain past this page."
                                            },
                                            "nextCursor": {
                                              "anyOf": [
                                                {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "maxLength": 512
                                                },
                                                {
                                                  "type": "null"
                                                }
                                              ],
                                              "description": "The cursor that reads the next page, or null when none remains."
                                            }
                                          },
                                          "required": [
                                            "entries",
                                            "hasMore",
                                            "nextCursor"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The entry's photos."
                                        },
                                        "text": {
                                          "type": "string",
                                          "description": "The note's text, as written; empty when the entry holds photos alone."
                                        },
                                        "language": {
                                          "type": [
                                            "string",
                                            "null"
                                          ],
                                          "description": "The language the note is written in."
                                        },
                                        "translation": {
                                          "type": "object",
                                          "properties": {
                                            "language": {
                                              "type": "string",
                                              "minLength": 2,
                                              "maxLength": 64,
                                              "description": "The reader's language the text is translated into."
                                            },
                                            "state": {
                                              "type": "string",
                                              "enum": [
                                                "ready",
                                                "pending",
                                                "failed",
                                                "paused"
                                              ],
                                              "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                            },
                                            "text": {
                                              "type": "string",
                                              "description": "The translated text, present once ready."
                                            }
                                          },
                                          "required": [
                                            "language",
                                            "state"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The note in the reader's language, when it is written in another."
                                        },
                                        "createdAt": {
                                          "type": "string",
                                          "format": "date-time",
                                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                          "description": "When the entry was written."
                                        }
                                      },
                                      "required": [
                                        "id",
                                        "photos",
                                        "text",
                                        "createdAt"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "description": "What the update holds: its notes, each with its photos."
                                  },
                                  "entriesPartial": {
                                    "type": "boolean",
                                    "description": "True when the update holds more entries than this page shows."
                                  }
                                },
                                "required": [
                                  "id",
                                  "author",
                                  "createdAt",
                                  "entries",
                                  "entriesPartial"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The updates on this page, newest first."
                            },
                            "hasMore": {
                              "type": "boolean",
                              "description": "True when older updates remain past this page."
                            },
                            "nextCursor": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 512
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The cursor that reads the next page, or null when none remains."
                            }
                          },
                          "required": [
                            "entries",
                            "hasMore",
                            "nextCursor"
                          ],
                          "additionalProperties": false,
                          "description": "The card's updates, newest first, one page."
                        },
                        "history": {
                          "type": "object",
                          "properties": {
                            "entries": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The entry's id."
                                  },
                                  "createdAt": {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                                    "description": "When the change was made."
                                  },
                                  "actor": {
                                    "anyOf": [
                                      {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "user",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "displayName": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The person's name as the project shows it."
                                              },
                                              "initials": {
                                                "type": "string",
                                                "description": "The person's initials, for an avatar with no photo."
                                              },
                                              "isViewer": {
                                                "type": "boolean",
                                                "description": "True when the person is the key's own person."
                                              },
                                              "photo": {
                                                "type": "object",
                                                "properties": {
                                                  "personId": {
                                                    "type": "string",
                                                    "format": "uuid",
                                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                    "description": "The person whose photo it is."
                                                  },
                                                  "version": {
                                                    "type": "integer",
                                                    "exclusiveMinimum": 0,
                                                    "maximum": 9007199254740991,
                                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                                  }
                                                },
                                                "required": [
                                                  "personId",
                                                  "version"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The person's photo, when they have one."
                                              },
                                              "via": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "connection",
                                                      "key"
                                                    ],
                                                    "description": "connection for an app connected by sign-in, key for an API key."
                                                  },
                                                  "name": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The app's or the key's name, as Werk shows it."
                                                  },
                                                  "verified": {
                                                    "type": "boolean",
                                                    "description": "True when Werk verified the app's identity."
                                                  },
                                                  "label": {
                                                    "type": "string",
                                                    "minLength": 1,
                                                    "description": "The caption Werk shows beside the change, in the reader's language."
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "name",
                                                  "verified",
                                                  "label"
                                                ],
                                                "additionalProperties": false,
                                                "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "displayName",
                                              "initials",
                                              "isViewer"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "connector",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "const": "schedule",
                                                "description": "user for a person; connector or schedule for a change Werk made without one."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The name Werk shows for a change made without a person."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "label"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Who made the change, or null when no longer known."
                                  },
                                  "label": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The change in one line, a step named as the project wrote it."
                                  },
                                  "labelTranslation": {
                                    "type": "object",
                                    "properties": {
                                      "language": {
                                        "type": "string",
                                        "minLength": 2,
                                        "maxLength": 64,
                                        "description": "The reader's language the text is translated into."
                                      },
                                      "state": {
                                        "type": "string",
                                        "enum": [
                                          "ready",
                                          "pending",
                                          "failed",
                                          "paused"
                                        ],
                                        "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "The translated text, present once ready."
                                      }
                                    },
                                    "required": [
                                      "language",
                                      "state"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The line in the reader's language, a step named by its translation."
                                  }
                                },
                                "required": [
                                  "id",
                                  "createdAt",
                                  "actor",
                                  "label"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The history's entries on this page, newest first."
                            },
                            "hasMore": {
                              "type": "boolean",
                              "description": "True when older entries remain past this page."
                            },
                            "nextCursor": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 512
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The cursor that reads the next page as historyBefore, or null when none remains."
                            }
                          },
                          "required": [
                            "entries",
                            "hasMore",
                            "nextCursor"
                          ],
                          "additionalProperties": false,
                          "description": "The card's history, newest first, one page: every change, who made it and when."
                        },
                        "duplicates": {
                          "type": "object",
                          "properties": {
                            "of": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "itemId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "That card's id."
                                    },
                                    "number": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "That card's number."
                                    },
                                    "title": {
                                      "type": "string",
                                      "description": "That card's title."
                                    },
                                    "status": {
                                      "type": "string",
                                      "description": "The name of the step that card is on."
                                    }
                                  },
                                  "required": [
                                    "itemId",
                                    "number",
                                    "title",
                                    "status"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The card this one was marked a duplicate of, or null."
                            },
                            "joined": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "itemId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "That card's id."
                                  },
                                  "number": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "That card's number."
                                  },
                                  "title": {
                                    "type": "string",
                                    "description": "That card's title."
                                  },
                                  "status": {
                                    "type": "string",
                                    "description": "The name of the step that card is on."
                                  }
                                },
                                "required": [
                                  "itemId",
                                  "number",
                                  "title",
                                  "status"
                                ],
                                "additionalProperties": false
                              },
                              "description": "The cards marked duplicates of this one."
                            }
                          },
                          "required": [
                            "of",
                            "joined"
                          ],
                          "additionalProperties": false,
                          "description": "How this card is joined to others as a duplicate."
                        }
                      },
                      "required": [
                        "followers",
                        "following",
                        "checklist",
                        "item",
                        "description",
                        "author",
                        "createdAt",
                        "assignedBy",
                        "photos",
                        "updates",
                        "history",
                        "duplicates"
                      ],
                      "additionalProperties": false,
                      "description": "The card in full."
                    }
                  },
                  "required": [
                    "projectId",
                    "conversationId",
                    "item"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                  "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                  "item": {
                    "followers": [
                      {
                        "kind": "user",
                        "displayName": "Tom Okafor",
                        "initials": "TO",
                        "isViewer": false
                      },
                      {
                        "kind": "user",
                        "displayName": "Maya Chen",
                        "initials": "MC",
                        "isViewer": true
                      }
                    ],
                    "following": true,
                    "checklist": {
                      "revision": 3,
                      "batches": [
                        {
                          "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                          "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                          "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                          "createdAt": "2026-11-19T16:10:00.000Z",
                          "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                        }
                      ],
                      "items": [
                        {
                          "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                          "position": 0,
                          "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                          "text": "Shut off the water under the sink",
                          "checked": true,
                          "checkedAt": "2026-11-19T16:20:00.000Z",
                          "checkedBy": {
                            "kind": "user",
                            "displayName": "Tom Okafor",
                            "initials": "TO",
                            "isViewer": false
                          }
                        },
                        {
                          "id": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                          "position": 1,
                          "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                          "text": "Pick up the new cartridge",
                          "checked": false,
                          "checkedAt": null,
                          "checkedBy": null
                        }
                      ],
                      "counts": {
                        "done": 1,
                        "total": 2
                      }
                    },
                    "item": {
                      "outcome": "open",
                      "id": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                      "ref": "#12",
                      "title": "Replace the leaking sink faucet",
                      "language": "en-US",
                      "status": {
                        "key": "waiting_parts",
                        "label": "Waiting for parts",
                        "category": "active",
                        "bucket": "waiting"
                      },
                      "dueNoticeLead": "at_due",
                      "due": null,
                      "assignee": {
                        "personId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "displayName": "Tom Okafor",
                        "initials": "TO"
                      },
                      "version": 4,
                      "number": 12,
                      "currentStep": {
                        "id": "waiting_parts",
                        "label": "Waiting for parts",
                        "bucket": "waiting"
                      },
                      "archived": false,
                      "counts": {
                        "photos": 1,
                        "updates": 1,
                        "documents": 0,
                        "checklist": {
                          "done": 1,
                          "total": 2
                        }
                      }
                    },
                    "description": "The kitchen faucet drips from its base. The replacement cartridge is on order.",
                    "author": {
                      "kind": "user",
                      "displayName": "Maya Chen",
                      "initials": "MC",
                      "isViewer": true
                    },
                    "createdAt": "2026-11-18T12:30:00.000Z",
                    "assignedBy": {
                      "kind": "user",
                      "displayName": "Maya Chen",
                      "initials": "MC",
                      "isViewer": true
                    },
                    "photos": {
                      "entries": [
                        {
                          "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                          "attachedBy": {
                            "kind": "user",
                            "displayName": "Tom Okafor",
                            "initials": "TO",
                            "isViewer": false
                          },
                          "asset": {
                            "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                            "kind": "image",
                            "mimeType": "image/jpeg",
                            "sizeBytes": 482113,
                            "width": 1600,
                            "height": 1200
                          },
                          "attachedAt": "2026-11-19T16:12:00.000Z",
                          "removable": true
                        }
                      ],
                      "hasMore": false,
                      "nextCursor": null
                    },
                    "updates": {
                      "entries": [
                        {
                          "id": "c9a3e7f1-4d6b-4f80-a2c8-5b1e9d3f7a46",
                          "author": {
                            "kind": "user",
                            "displayName": "Tom Okafor",
                            "initials": "TO",
                            "isViewer": false
                          },
                          "createdAt": "2026-11-19T16:12:00.000Z",
                          "entries": [
                            {
                              "id": "e5b9d3a7-2f8c-4b14-9e6a-7c0f2d4b8e33",
                              "photos": {
                                "entries": [
                                  {
                                    "id": "b8f2d6a4-3e1c-4b79-9d05-6a3e8c2f1b97",
                                    "attachedBy": {
                                      "kind": "user",
                                      "displayName": "Tom Okafor",
                                      "initials": "TO",
                                      "isViewer": false
                                    },
                                    "asset": {
                                      "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                                      "kind": "image",
                                      "mimeType": "image/jpeg",
                                      "sizeBytes": 482113,
                                      "width": 1600,
                                      "height": 1200
                                    },
                                    "attachedAt": "2026-11-19T16:12:00.000Z",
                                    "removable": true
                                  }
                                ],
                                "hasMore": false,
                                "nextCursor": null
                              },
                              "text": "The base is cracked, so the whole faucet goes. Parts ordered.",
                              "language": "en-US",
                              "createdAt": "2026-11-19T16:12:00.000Z"
                            }
                          ],
                          "entriesPartial": false
                        }
                      ],
                      "hasMore": false,
                      "nextCursor": null
                    },
                    "history": {
                      "entries": [
                        {
                          "id": "f6c0e4b8-3a9d-4c25-8f1b-6d2a0e5c9f47",
                          "createdAt": "2026-11-19T16:15:00.000Z",
                          "actor": {
                            "kind": "user",
                            "displayName": "Tom Okafor",
                            "initials": "TO",
                            "isViewer": false
                          },
                          "label": "Tom Okafor moved it to Waiting for parts"
                        }
                      ],
                      "hasMore": false,
                      "nextCursor": null
                    },
                    "duplicates": {
                      "of": null,
                      "joined": []
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_cursor"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired",
              "project_profile_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/changes": {
      "get": {
        "operationId": "GET /api/v1/account/changes",
        "tags": [
          "projects"
        ],
        "summary": "List account changes",
        "description": "What changed in the key's person's projects since a cursor: their people, their list, their Pulse, their plan.\n\nEach change names what to read again, never its content. An outside client has no way to get a first cursor today, so every call answers cursor_expired.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": true,
            "description": "The cursor of the last change read.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "YWNjb3VudDo0MjE"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many changes a page holds.",
            "schema": {
              "default": 100,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "50"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The changes after the cursor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "changes": {
                      "type": "array",
                      "items": {
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "cursor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 512,
                                "description": "The change's cursor."
                              },
                              "kind": {
                                "type": "string",
                                "const": "project_people_changed",
                                "description": "What changed: a project's people, the project list, the plan, Pulse, the Google Calendar connection, or the language chosen."
                              },
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project the change is about."
                              },
                              "peopleVersion": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The project's people version after the change."
                              }
                            },
                            "required": [
                              "cursor",
                              "kind",
                              "projectId",
                              "peopleVersion"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "cursor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 512,
                                "description": "The change's cursor."
                              },
                              "kind": {
                                "type": "string",
                                "const": "projects_changed",
                                "description": "What changed: a project's people, the project list, the plan, Pulse, the Google Calendar connection, or the language chosen."
                              },
                              "projectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The project the change is about."
                              },
                              "invalidationVersion": {
                                "type": "string",
                                "pattern": "^[1-9]\\d{0,18}$",
                                "description": "Grows with each change to the project, so an older change can be told from a newer one."
                              },
                              "projectStatuses": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "projectId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The project's id."
                                    },
                                    "conversationId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                                    },
                                    "archived": {
                                      "type": "boolean",
                                      "description": "True when the project is archived."
                                    },
                                    "ownerName": {
                                      "type": "string",
                                      "description": "The owner's name."
                                    },
                                    "isOwner": {
                                      "type": "boolean",
                                      "description": "True when the key's person owns the project."
                                    },
                                    "viewerRole": {
                                      "type": "string",
                                      "enum": [
                                        "owner",
                                        "admin",
                                        "member",
                                        "collaborator"
                                      ],
                                      "description": "The key's person's role in the project."
                                    },
                                    "projectConfigVersion": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                                    },
                                    "capabilities": {
                                      "type": "object",
                                      "properties": {
                                        "invite": {
                                          "type": "boolean",
                                          "description": "True when the key's person may invite people to the project."
                                        },
                                        "managePeople": {
                                          "type": "boolean",
                                          "description": "True when they may manage the project's people."
                                        },
                                        "changeRoles": {
                                          "type": "boolean",
                                          "description": "True when they may make a person an admin or a member."
                                        },
                                        "removePeople": {
                                          "type": "boolean",
                                          "description": "True when they may remove people from the project."
                                        },
                                        "editLists": {
                                          "type": "boolean",
                                          "description": "True when they may change the project's steps."
                                        },
                                        "archive": {
                                          "type": "boolean",
                                          "description": "True when they may archive the project."
                                        },
                                        "restore": {
                                          "type": "boolean",
                                          "description": "True when they may bring the project back from the archive."
                                        },
                                        "delete": {
                                          "type": "boolean",
                                          "description": "True when they may delete the project."
                                        },
                                        "transferOwnership": {
                                          "type": "boolean",
                                          "description": "True when they may hand the project to another person and leave it."
                                        },
                                        "rename": {
                                          "type": "boolean",
                                          "description": "True when they may rename the project."
                                        },
                                        "changePhoto": {
                                          "type": "boolean",
                                          "description": "True when they may change the project's photo."
                                        },
                                        "leave": {
                                          "type": "boolean",
                                          "description": "True when they may leave the project."
                                        }
                                      },
                                      "required": [
                                        "invite",
                                        "managePeople",
                                        "changeRoles",
                                        "removePeople",
                                        "editLists",
                                        "archive",
                                        "restore",
                                        "delete",
                                        "transferOwnership",
                                        "rename",
                                        "changePhoto",
                                        "leave"
                                      ],
                                      "additionalProperties": false,
                                      "description": "What the key's person may do with the project now."
                                    }
                                  },
                                  "required": [
                                    "projectId",
                                    "conversationId",
                                    "archived",
                                    "ownerName",
                                    "isOwner",
                                    "viewerRole",
                                    "projectConfigVersion",
                                    "capabilities"
                                  ],
                                  "additionalProperties": false
                                },
                                "description": "The projects' current state, for a change of the list or of the plan."
                              },
                              "removedProjectId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "A project that left the key's person's list: they were removed from it, or it is being deleted."
                              },
                              "rowOnly": {
                                "type": "boolean",
                                "const": true,
                                "description": "True when only the key's person's own settings for the project changed, not its cards."
                              }
                            },
                            "required": [
                              "cursor",
                              "kind"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "cursor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 512,
                                "description": "The change's cursor."
                              },
                              "kind": {
                                "type": "string",
                                "const": "plan_changed",
                                "description": "What changed: a project's people, the project list, the plan, Pulse, the Google Calendar connection, or the language chosen."
                              },
                              "projectStatuses": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "projectId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The project's id."
                                    },
                                    "conversationId": {
                                      "type": "string",
                                      "format": "uuid",
                                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                      "description": "The id Werk's apps use for the key's person's view of this project; the API's paths take projectId."
                                    },
                                    "archived": {
                                      "type": "boolean",
                                      "description": "True when the project is archived."
                                    },
                                    "ownerName": {
                                      "type": "string",
                                      "description": "The owner's name."
                                    },
                                    "isOwner": {
                                      "type": "boolean",
                                      "description": "True when the key's person owns the project."
                                    },
                                    "viewerRole": {
                                      "type": "string",
                                      "enum": [
                                        "owner",
                                        "admin",
                                        "member",
                                        "collaborator"
                                      ],
                                      "description": "The key's person's role in the project."
                                    },
                                    "projectConfigVersion": {
                                      "type": "integer",
                                      "exclusiveMinimum": 0,
                                      "maximum": 9007199254740991,
                                      "description": "The version of the project's settings (its name, steps and archive), which grows with each change to them; such a change sends it as expectedConfigVersion."
                                    },
                                    "capabilities": {
                                      "type": "object",
                                      "properties": {
                                        "invite": {
                                          "type": "boolean",
                                          "description": "True when the key's person may invite people to the project."
                                        },
                                        "managePeople": {
                                          "type": "boolean",
                                          "description": "True when they may manage the project's people."
                                        },
                                        "changeRoles": {
                                          "type": "boolean",
                                          "description": "True when they may make a person an admin or a member."
                                        },
                                        "removePeople": {
                                          "type": "boolean",
                                          "description": "True when they may remove people from the project."
                                        },
                                        "editLists": {
                                          "type": "boolean",
                                          "description": "True when they may change the project's steps."
                                        },
                                        "archive": {
                                          "type": "boolean",
                                          "description": "True when they may archive the project."
                                        },
                                        "restore": {
                                          "type": "boolean",
                                          "description": "True when they may bring the project back from the archive."
                                        },
                                        "delete": {
                                          "type": "boolean",
                                          "description": "True when they may delete the project."
                                        },
                                        "transferOwnership": {
                                          "type": "boolean",
                                          "description": "True when they may hand the project to another person and leave it."
                                        },
                                        "rename": {
                                          "type": "boolean",
                                          "description": "True when they may rename the project."
                                        },
                                        "changePhoto": {
                                          "type": "boolean",
                                          "description": "True when they may change the project's photo."
                                        },
                                        "leave": {
                                          "type": "boolean",
                                          "description": "True when they may leave the project."
                                        }
                                      },
                                      "required": [
                                        "invite",
                                        "managePeople",
                                        "changeRoles",
                                        "removePeople",
                                        "editLists",
                                        "archive",
                                        "restore",
                                        "delete",
                                        "transferOwnership",
                                        "rename",
                                        "changePhoto",
                                        "leave"
                                      ],
                                      "additionalProperties": false,
                                      "description": "What the key's person may do with the project now."
                                    }
                                  },
                                  "required": [
                                    "projectId",
                                    "conversationId",
                                    "archived",
                                    "ownerName",
                                    "isOwner",
                                    "viewerRole",
                                    "projectConfigVersion",
                                    "capabilities"
                                  ],
                                  "additionalProperties": false
                                },
                                "description": "The projects' current state, for a change of the list or of the plan."
                              }
                            },
                            "required": [
                              "cursor",
                              "kind"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "cursor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 512,
                                "description": "The change's cursor."
                              },
                              "kind": {
                                "type": "string",
                                "const": "for_you_changed",
                                "description": "What changed: a project's people, the project list, the plan, Pulse, the Google Calendar connection, or the language chosen."
                              },
                              "unreadCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "How many Pulse rows are unread now."
                              }
                            },
                            "required": [
                              "cursor",
                              "kind",
                              "unreadCount"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "cursor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 512,
                                "description": "The change's cursor."
                              },
                              "kind": {
                                "type": "string",
                                "const": "google_calendar_changed",
                                "description": "What changed: a project's people, the project list, the plan, Pulse, the Google Calendar connection, or the language chosen."
                              }
                            },
                            "required": [
                              "cursor",
                              "kind"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "object",
                            "properties": {
                              "cursor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 512,
                                "description": "The change's cursor."
                              },
                              "kind": {
                                "type": "string",
                                "const": "locale_changed",
                                "description": "What changed: a project's people, the project list, the plan, Pulse, the Google Calendar connection, or the language chosen."
                              }
                            },
                            "required": [
                              "cursor",
                              "kind"
                            ],
                            "additionalProperties": false
                          }
                        ]
                      },
                      "description": "The changes, oldest first."
                    },
                    "cursor": {
                      "type": "string",
                      "description": "The cursor to read the next changes from."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "True when more changes wait past this page."
                    }
                  },
                  "required": [
                    "changes",
                    "cursor",
                    "hasMore"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "changes": [
                    {
                      "cursor": "YWNjb3VudDo0MjI",
                      "kind": "project_people_changed",
                      "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                      "peopleVersion": 4
                    }
                  ],
                  "cursor": "YWNjb3VudDo0MjI",
                  "hasMore": false
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_limit"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/follow": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/follow",
        "tags": [
          "cards"
        ],
        "summary": "Follow a card",
        "description": "The key's person follows the card and is told of its changes.\n\nFollowing a card already followed changes nothing.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f12"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Whether the key's person follows the card now.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "itemId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The card's id."
                    },
                    "following": {
                      "type": "boolean",
                      "description": "True when the key's person follows the card now."
                    },
                    "followerCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many people follow the card now."
                    }
                  },
                  "required": [
                    "itemId",
                    "following",
                    "followerCount"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                  "following": true,
                  "followerCount": 2
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_follow"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/unfollow": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/unfollow",
        "tags": [
          "cards"
        ],
        "summary": "Unfollow a card",
        "description": "The key's person stops following the card.\n\nNot following it already changes nothing.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  }
                },
                "required": [
                  "clientRequestId"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f13"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Whether the key's person follows the card now.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "itemId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The card's id."
                    },
                    "following": {
                      "type": "boolean",
                      "description": "True when the key's person follows the card now."
                    },
                    "followerCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many people follow the card now."
                    }
                  },
                  "required": [
                    "itemId",
                    "following",
                    "followerCount"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                  "following": false,
                  "followerCount": 1
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_follow"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/follow-invitations/{invitationId}": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/follow-invitations/:invitationId",
        "tags": [
          "cards"
        ],
        "summary": "Get a follow invitation",
        "description": "An invitation to follow a card, sent to or by the key's person.\n\nOne that was answered, lapsed, or whose card either person no longer sees is not found.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "invitationId",
            "in": "path",
            "required": true,
            "description": "The invitation's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The invitation.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "invitation": {
                      "type": "object",
                      "properties": {
                        "itemId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card the invitation is to follow."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The invitation's version; the answer sends it as expectedVersion."
                        },
                        "expiresAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "When the invitation lapses if not answered."
                        },
                        "inviter": {
                          "type": "object",
                          "properties": {
                            "userId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person's id."
                            },
                            "displayName": {
                              "type": "string",
                              "description": "The person's name as the project shows it."
                            },
                            "initials": {
                              "type": "string",
                              "description": "The person's initials, for an avatar with no photo."
                            },
                            "isViewer": {
                              "type": "boolean",
                              "description": "True when the person is the key's own person."
                            },
                            "photo": {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person whose photo it is."
                                },
                                "version": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "personId",
                                "version"
                              ],
                              "additionalProperties": false,
                              "description": "The person's photo, when they have one."
                            }
                          },
                          "required": [
                            "userId",
                            "displayName",
                            "initials",
                            "isViewer"
                          ],
                          "additionalProperties": false,
                          "description": "Who sent the invitation."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The invitation's id."
                        }
                      },
                      "required": [
                        "itemId",
                        "version",
                        "expiresAt",
                        "inviter",
                        "id"
                      ],
                      "additionalProperties": false,
                      "description": "The invitation."
                    }
                  },
                  "required": [
                    "invitation"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "invitation": {
                    "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                    "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "version": 1,
                    "expiresAt": "2026-11-28T14:05:00.000Z",
                    "inviter": {
                      "userId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO",
                      "isViewer": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "follow_invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/follow-invitations/{invitationId}/respond": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/follow-invitations/:invitationId/respond",
        "tags": [
          "cards"
        ],
        "summary": "Answer a follow invitation",
        "description": "Accepts an invitation to follow a card, which follows it, or ignores it.\n\nA second answer is refused.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "invitationId",
            "in": "path",
            "required": true,
            "description": "The invitation's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The invitation's version as last read."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "accept",
                      "ignore"
                    ],
                    "description": "accept follows the card, ignore declines the invitation."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f15",
                "expectedVersion": 1,
                "action": "accept"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the request did.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "applied",
                        "unchanged"
                      ],
                      "description": "applied when the answer was recorded, unchanged when it already was."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The invitation's id."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The invitation's version after the answer."
                    }
                  },
                  "required": [
                    "kind",
                    "id",
                    "version"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "kind": "applied",
                  "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                  "version": 2
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_follow",
              "follow_invitation_unavailable"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "follow_invitation_actor_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "follow_invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "follow_invitation_stale",
              "follow_invitation_expired",
              "follow_invitation_request_conflict"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/settings": {
      "get": {
        "operationId": "GET /api/v1/settings",
        "tags": [
          "profile"
        ],
        "summary": "List the settings",
        "description": "The key's person's own settings, each with its value and whether a key may change it.\n\nAn API key may change the translation of cards only; the rest are changed in Werk's apps.",
        "x-werk-group": "read",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "responses": {
          "200": {
            "description": "The settings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "level": {
                      "type": "string",
                      "enum": [
                        "person",
                        "project",
                        "project_person"
                      ],
                      "description": "Whose settings these are: the account's or a project's."
                    },
                    "settings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "enum": [
                              "brief_time",
                              "brief_on",
                              "brief_resume_date",
                              "email_due_notices",
                              "email_own_reminders",
                              "email_invitations",
                              "push_my_cards",
                              "push_due_notices",
                              "push_own_reminders",
                              "push_invitations",
                              "push_project_people",
                              "push_from_werk",
                              "translate_cards",
                              "translate_offer",
                              "cards_drawer_level",
                              "quiet_hours_on",
                              "quiet_start",
                              "quiet_end",
                              "quiet_days",
                              "quiet_until",
                              "due_notice_lead",
                              "color",
                              "highlighted",
                              "muted",
                              "in_morning_brief",
                              "translate_offer_closed"
                            ],
                            "description": "The setting's name."
                          },
                          "value": {
                            "type": [
                              "boolean",
                              "string",
                              "number",
                              "null"
                            ],
                            "description": "The setting's value."
                          },
                          "version": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The setting's version, which a change sends as expectedVersion; 0 for one never set."
                          },
                          "updatedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When it last changed, or null when never set."
                          },
                          "canWrite": {
                            "type": "boolean",
                            "description": "True when the caller may change it."
                          }
                        },
                        "required": [
                          "key",
                          "value",
                          "version",
                          "updatedAt",
                          "canWrite"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Each setting with its value."
                    }
                  },
                  "required": [
                    "level",
                    "settings"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "level": "person",
                  "settings": [
                    {
                      "key": "translate_cards",
                      "value": true,
                      "version": 1,
                      "updatedAt": "2026-10-30T12:00:00.000Z",
                      "canWrite": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/settings",
        "tags": [
          "profile"
        ],
        "summary": "Change a setting",
        "description": "Changes one of the key's person's own settings.\n\nAn API key may change translate_cards only; any other answers not_for_client. Refused when the setting changed since it was read.",
        "x-werk-group": "change",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "key": {
                    "type": "string",
                    "enum": [
                      "brief_time",
                      "brief_on",
                      "brief_resume_date",
                      "email_due_notices",
                      "email_own_reminders",
                      "email_invitations",
                      "push_my_cards",
                      "push_due_notices",
                      "push_own_reminders",
                      "push_invitations",
                      "push_project_people",
                      "push_from_werk",
                      "translate_cards",
                      "translate_offer",
                      "cards_drawer_level",
                      "quiet_hours_on",
                      "quiet_start",
                      "quiet_end",
                      "quiet_days",
                      "quiet_until",
                      "due_notice_lead",
                      "color",
                      "highlighted",
                      "muted",
                      "in_morning_brief",
                      "translate_offer_closed"
                    ],
                    "description": "The setting's name."
                  },
                  "value": {
                    "type": [
                      "boolean",
                      "string",
                      "number",
                      "null"
                    ],
                    "description": "The setting's new value."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2147483646,
                    "description": "The setting's version as last read, 0 for one never set; when it changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "key",
                  "value",
                  "expectedVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4c06",
                "key": "translate_cards",
                "value": false,
                "expectedVersion": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The setting after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "enum": [
                        "brief_time",
                        "brief_on",
                        "brief_resume_date",
                        "email_due_notices",
                        "email_own_reminders",
                        "email_invitations",
                        "push_my_cards",
                        "push_due_notices",
                        "push_own_reminders",
                        "push_invitations",
                        "push_project_people",
                        "push_from_werk",
                        "translate_cards",
                        "translate_offer",
                        "cards_drawer_level",
                        "quiet_hours_on",
                        "quiet_start",
                        "quiet_end",
                        "quiet_days",
                        "quiet_until",
                        "due_notice_lead",
                        "color",
                        "highlighted",
                        "muted",
                        "in_morning_brief",
                        "translate_offer_closed"
                      ],
                      "description": "The setting's name."
                    },
                    "value": {
                      "type": [
                        "boolean",
                        "string",
                        "number",
                        "null"
                      ],
                      "description": "The setting's value."
                    },
                    "version": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The setting's version, which a change sends as expectedVersion; 0 for one never set."
                    },
                    "updatedAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When it last changed, or null when never set."
                    },
                    "canWrite": {
                      "type": "boolean",
                      "description": "True when the caller may change it."
                    }
                  },
                  "required": [
                    "key",
                    "value",
                    "version",
                    "updatedAt",
                    "canWrite"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "key": "translate_cards",
                  "value": false,
                  "version": 2,
                  "updatedAt": "2026-11-21T14:05:00.000Z",
                  "canWrite": true
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_setting"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_for_client"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "setting_version_conflict",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/settings/{key}/history": {
      "get": {
        "operationId": "GET /api/v1/settings/:key/history",
        "tags": [
          "profile"
        ],
        "summary": "List a setting's history",
        "description": "The changes of one of the key's person's settings, or of their name, photo, time zone or device language, newest first.\n\nEach change says through which connected app or key it came when it came from outside Werk's apps.",
        "x-werk-group": "read",
        "x-werk-area": "profile",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "description": "The setting's name, or person_name, person_photo, person_timezone or phone_locale.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "brief_time",
                    "brief_on",
                    "brief_resume_date",
                    "email_due_notices",
                    "email_own_reminders",
                    "email_invitations",
                    "push_my_cards",
                    "push_due_notices",
                    "push_own_reminders",
                    "push_invitations",
                    "push_project_people",
                    "push_from_werk",
                    "translate_cards",
                    "translate_offer",
                    "cards_drawer_level",
                    "quiet_hours_on",
                    "quiet_start",
                    "quiet_end",
                    "quiet_days",
                    "quiet_until",
                    "due_notice_lead",
                    "color",
                    "highlighted",
                    "muted",
                    "in_morning_brief",
                    "translate_offer_closed"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "person_name",
                    "person_photo",
                    "person_timezone",
                    "phone_locale",
                    "project_name",
                    "project_steps",
                    "project_photo"
                  ]
                }
              ]
            },
            "example": "translate_cards"
          },
          {
            "name": "beforeVersion",
            "in": "query",
            "required": false,
            "description": "Reads the changes made before this version; left out, from the newest.",
            "schema": {
              "default": 2147483647,
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many changes a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "20"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The changes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "changes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "actorId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The person who made the change."
                          },
                          "before": {
                            "$ref": "#/$defs/__schema0",
                            "description": "The value before the change."
                          },
                          "after": {
                            "$ref": "#/$defs/__schema1",
                            "description": "The value after the change."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The setting's version after the change."
                          },
                          "changedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the change was made."
                          },
                          "via": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "connection",
                                  "key"
                                ],
                                "description": "connection for an app connected by sign-in, key for an API key."
                              },
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The app's or the key's name, as Werk shows it."
                              },
                              "verified": {
                                "type": "boolean",
                                "description": "True when Werk verified the app's identity."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The caption Werk shows beside the change, in the reader's language."
                              }
                            },
                            "required": [
                              "kind",
                              "name",
                              "verified",
                              "label"
                            ],
                            "additionalProperties": false,
                            "description": "The connected app or API key the change came through; absent for one made in Werk's apps."
                          }
                        },
                        "required": [
                          "actorId",
                          "before",
                          "after",
                          "version",
                          "changedAt"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The setting's changes, newest first."
                    },
                    "nextBeforeVersion": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The version to read the next, older page from as beforeVersion, or null when none remains."
                    }
                  },
                  "required": [
                    "changes",
                    "nextBeforeVersion"
                  ],
                  "additionalProperties": false,
                  "$defs": {
                    "__schema0": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        },
                        {
                          "type": "array",
                          "items": {
                            "$ref": "#/$defs/__schema0"
                          }
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/$defs/__schema0"
                          }
                        }
                      ]
                    },
                    "__schema1": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        },
                        {
                          "type": "array",
                          "items": {
                            "$ref": "#/$defs/__schema1"
                          }
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/$defs/__schema1"
                          }
                        }
                      ]
                    }
                  }
                },
                "example": {
                  "changes": [
                    {
                      "actorId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "before": false,
                      "after": true,
                      "version": 1,
                      "changedAt": "2026-10-30T12:00:00.000Z"
                    }
                  ],
                  "nextBeforeVersion": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_setting"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/settings": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/settings",
        "tags": [
          "projects"
        ],
        "summary": "List a project's settings",
        "description": "The project's settings, each with its value and whether the caller may change it.\n\nToday it holds the default due notice lead that new cards take.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "responses": {
          "200": {
            "description": "The settings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "level": {
                      "type": "string",
                      "enum": [
                        "person",
                        "project",
                        "project_person"
                      ],
                      "description": "Whose settings these are: the account's or a project's."
                    },
                    "settings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "enum": [
                              "brief_time",
                              "brief_on",
                              "brief_resume_date",
                              "email_due_notices",
                              "email_own_reminders",
                              "email_invitations",
                              "push_my_cards",
                              "push_due_notices",
                              "push_own_reminders",
                              "push_invitations",
                              "push_project_people",
                              "push_from_werk",
                              "translate_cards",
                              "translate_offer",
                              "cards_drawer_level",
                              "quiet_hours_on",
                              "quiet_start",
                              "quiet_end",
                              "quiet_days",
                              "quiet_until",
                              "due_notice_lead",
                              "color",
                              "highlighted",
                              "muted",
                              "in_morning_brief",
                              "translate_offer_closed"
                            ],
                            "description": "The setting's name."
                          },
                          "value": {
                            "type": [
                              "boolean",
                              "string",
                              "number",
                              "null"
                            ],
                            "description": "The setting's value."
                          },
                          "version": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The setting's version, which a change sends as expectedVersion; 0 for one never set."
                          },
                          "updatedAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When it last changed, or null when never set."
                          },
                          "canWrite": {
                            "type": "boolean",
                            "description": "True when the caller may change it."
                          }
                        },
                        "required": [
                          "key",
                          "value",
                          "version",
                          "updatedAt",
                          "canWrite"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Each setting with its value."
                    }
                  },
                  "required": [
                    "level",
                    "settings"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "level": "project",
                  "settings": [
                    {
                      "key": "due_notice_lead",
                      "value": "1_day",
                      "version": 2,
                      "updatedAt": "2026-11-02T16:20:00.000Z",
                      "canWrite": true
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/settings",
        "tags": [
          "projects"
        ],
        "summary": "Change a project's setting",
        "description": "Changes one of the project's settings.\n\nThe project's owner and admins may change them; an API key may change the default due notice lead only. Refused when the setting changed since it was read.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "key": {
                    "type": "string",
                    "enum": [
                      "brief_time",
                      "brief_on",
                      "brief_resume_date",
                      "email_due_notices",
                      "email_own_reminders",
                      "email_invitations",
                      "push_my_cards",
                      "push_due_notices",
                      "push_own_reminders",
                      "push_invitations",
                      "push_project_people",
                      "push_from_werk",
                      "translate_cards",
                      "translate_offer",
                      "cards_drawer_level",
                      "quiet_hours_on",
                      "quiet_start",
                      "quiet_end",
                      "quiet_days",
                      "quiet_until",
                      "due_notice_lead",
                      "color",
                      "highlighted",
                      "muted",
                      "in_morning_brief",
                      "translate_offer_closed"
                    ],
                    "description": "The setting's name."
                  },
                  "value": {
                    "type": [
                      "boolean",
                      "string",
                      "number",
                      "null"
                    ],
                    "description": "The setting's new value."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2147483646,
                    "description": "The setting's version as last read; when it changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "key",
                  "value",
                  "expectedVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b06",
                "key": "due_notice_lead",
                "value": "1_day",
                "expectedVersion": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The setting after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "enum": [
                        "brief_time",
                        "brief_on",
                        "brief_resume_date",
                        "email_due_notices",
                        "email_own_reminders",
                        "email_invitations",
                        "push_my_cards",
                        "push_due_notices",
                        "push_own_reminders",
                        "push_invitations",
                        "push_project_people",
                        "push_from_werk",
                        "translate_cards",
                        "translate_offer",
                        "cards_drawer_level",
                        "quiet_hours_on",
                        "quiet_start",
                        "quiet_end",
                        "quiet_days",
                        "quiet_until",
                        "due_notice_lead",
                        "color",
                        "highlighted",
                        "muted",
                        "in_morning_brief",
                        "translate_offer_closed"
                      ],
                      "description": "The setting's name."
                    },
                    "value": {
                      "type": [
                        "boolean",
                        "string",
                        "number",
                        "null"
                      ],
                      "description": "The setting's value."
                    },
                    "version": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The setting's version, which a change sends as expectedVersion; 0 for one never set."
                    },
                    "updatedAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When it last changed, or null when never set."
                    },
                    "canWrite": {
                      "type": "boolean",
                      "description": "True when the caller may change it."
                    }
                  },
                  "required": [
                    "key",
                    "value",
                    "version",
                    "updatedAt",
                    "canWrite"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "key": "due_notice_lead",
                  "value": "1_day",
                  "version": 3,
                  "updatedAt": "2026-11-21T14:05:00.000Z",
                  "canWrite": true
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_setting"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "setting_version_conflict",
              "request_conflict",
              "request_erased"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/settings/{key}/history": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/settings/:key/history",
        "tags": [
          "projects"
        ],
        "summary": "List a project setting's history",
        "description": "The changes of one of the project's settings or of its name, steps or photo, newest first.\n\nEach change says who made it, and through which connected app or key when it came from outside Werk's apps.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "key",
            "in": "path",
            "required": true,
            "description": "The setting's name, or project_name, project_steps or project_photo.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "brief_time",
                    "brief_on",
                    "brief_resume_date",
                    "email_due_notices",
                    "email_own_reminders",
                    "email_invitations",
                    "push_my_cards",
                    "push_due_notices",
                    "push_own_reminders",
                    "push_invitations",
                    "push_project_people",
                    "push_from_werk",
                    "translate_cards",
                    "translate_offer",
                    "cards_drawer_level",
                    "quiet_hours_on",
                    "quiet_start",
                    "quiet_end",
                    "quiet_days",
                    "quiet_until",
                    "due_notice_lead",
                    "color",
                    "highlighted",
                    "muted",
                    "in_morning_brief",
                    "translate_offer_closed"
                  ]
                },
                {
                  "type": "string",
                  "enum": [
                    "person_name",
                    "person_photo",
                    "person_timezone",
                    "phone_locale",
                    "project_name",
                    "project_steps",
                    "project_photo"
                  ]
                }
              ]
            },
            "example": "due_notice_lead"
          },
          {
            "name": "beforeVersion",
            "in": "query",
            "required": false,
            "description": "Reads the changes made before this version; left out, from the newest.",
            "schema": {
              "default": 2147483647,
              "type": "integer",
              "minimum": 1,
              "maximum": 2147483647
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many changes a page holds.",
            "schema": {
              "default": 50,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "20"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The changes.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "changes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "actorId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The person who made the change."
                          },
                          "before": {
                            "$ref": "#/$defs/__schema0",
                            "description": "The value before the change."
                          },
                          "after": {
                            "$ref": "#/$defs/__schema1",
                            "description": "The value after the change."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The setting's version after the change."
                          },
                          "changedAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the change was made."
                          },
                          "via": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "connection",
                                  "key"
                                ],
                                "description": "connection for an app connected by sign-in, key for an API key."
                              },
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The app's or the key's name, as Werk shows it."
                              },
                              "verified": {
                                "type": "boolean",
                                "description": "True when Werk verified the app's identity."
                              },
                              "label": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The caption Werk shows beside the change, in the reader's language."
                              }
                            },
                            "required": [
                              "kind",
                              "name",
                              "verified",
                              "label"
                            ],
                            "additionalProperties": false,
                            "description": "The connected app or API key the change came through; absent for one made in Werk's apps."
                          }
                        },
                        "required": [
                          "actorId",
                          "before",
                          "after",
                          "version",
                          "changedAt"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The setting's changes, newest first."
                    },
                    "nextBeforeVersion": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The version to read the next, older page from as beforeVersion, or null when none remains."
                    }
                  },
                  "required": [
                    "changes",
                    "nextBeforeVersion"
                  ],
                  "additionalProperties": false,
                  "$defs": {
                    "__schema0": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        },
                        {
                          "type": "array",
                          "items": {
                            "$ref": "#/$defs/__schema0"
                          }
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/$defs/__schema0"
                          }
                        }
                      ]
                    },
                    "__schema1": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "null"
                        },
                        {
                          "type": "array",
                          "items": {
                            "$ref": "#/$defs/__schema1"
                          }
                        },
                        {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/$defs/__schema1"
                          }
                        }
                      ]
                    }
                  }
                },
                "example": {
                  "changes": [
                    {
                      "actorId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "before": "at_due",
                      "after": "1_day",
                      "version": 2,
                      "changedAt": "2026-11-02T16:20:00.000Z"
                    }
                  ],
                  "nextBeforeVersion": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_setting"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/delete": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/delete",
        "tags": [
          "projects"
        ],
        "summary": "Preview a project's deletion",
        "description": "What deleting the project would remove, and whether the key's person may delete it.\n\nOnly the owner may delete a project, and never My Werk. It refuses nobody: a person who may not delete reads canDelete false.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "responses": {
          "200": {
            "description": "The preview.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "canDelete": {
                      "type": "boolean",
                      "description": "True when the key's person may delete the project now."
                    },
                    "project": {
                      "type": "object",
                      "properties": {
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The project's id."
                        },
                        "conversationId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The id Werk's apps use for the key's person's view of the project."
                        },
                        "name": {
                          "type": "string",
                          "description": "The project's name."
                        },
                        "memberCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "How many people the project has."
                        }
                      },
                      "required": [
                        "projectId",
                        "conversationId",
                        "name",
                        "memberCount"
                      ],
                      "additionalProperties": false,
                      "description": "The project."
                    },
                    "cardCount": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many cards the project holds, which are deleted with it."
                    },
                    "graceDays": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "How many days a deleted project waits before it is gone for good; until then its owner can restore it."
                    },
                    "configVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The project's settings version, which the delete request sends as expectedConfigVersion."
                    }
                  },
                  "required": [
                    "canDelete",
                    "project",
                    "cardCount",
                    "graceDays",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "canDelete": true,
                  "project": {
                    "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                    "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                    "name": "Harbor Street kitchen",
                    "memberCount": 3
                  },
                  "cardCount": 7,
                  "graceDays": 30,
                  "configVersion": 6
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/delete",
        "tags": [
          "projects"
        ],
        "summary": "Delete a project",
        "description": "Sets the project to be deleted after its grace days; until then its owner can restore it.\n\nOnly the owner may delete it, and never My Werk. The project leaves everyone's list at once, its scheduled reminders are cancelled, and every other person in it is told. Refused when the project's settings changed since they were read.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedConfigVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The project's projectConfigVersion as last read; when its settings changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedConfigVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b07",
                "expectedConfigVersion": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project's deletion, with when it is gone for good.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversationId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id Werk's apps use for the key's person's view of the project."
                    },
                    "projectId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The project's id."
                    },
                    "configVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The project's settings version after the request."
                    },
                    "deleteAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "description": "When the project is gone for good unless it is restored before; absent once restored."
                    }
                  },
                  "required": [
                    "conversationId",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                  "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                  "configVersion": 7,
                  "deleteAt": "2026-12-21T14:05:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "project_config_changed"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/restore": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/restore",
        "tags": [
          "projects"
        ],
        "summary": "Restore a project",
        "description": "Brings back a project waiting to be deleted, before its grace days end.\n\nOnly the owner may restore it; every other person in it is told. Reminders cancelled by the deletion stay cancelled.",
        "x-werk-group": "change",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedConfigVersion": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991,
                    "description": "The project's projectConfigVersion as last read; when its settings changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedConfigVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b08",
                "expectedConfigVersion": 7
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The project, restored.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "conversationId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id Werk's apps use for the key's person's view of the project."
                    },
                    "projectId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The project's id."
                    },
                    "configVersion": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The project's settings version after the request."
                    },
                    "deleteAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                      "description": "When the project is gone for good unless it is restored before; absent once restored."
                    }
                  },
                  "required": [
                    "conversationId",
                    "configVersion"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                  "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                  "configVersion": 8
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_project_request"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_project_restricted",
              "project_not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "project_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "project_deletion_expired",
              "project_config_changed",
              "project_not_deleting"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/deleting-projects": {
      "get": {
        "operationId": "GET /api/v1/deleting-projects",
        "tags": [
          "projects"
        ],
        "summary": "List projects being deleted",
        "description": "The projects the key's person owns that wait to be deleted and can still be restored.\n\nSoonest to go first.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "responses": {
          "200": {
            "description": "The projects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "projects": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "conversationId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The id Werk's apps use for the key's person's view of the project."
                          },
                          "projectId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The project's id."
                          },
                          "name": {
                            "type": "string",
                            "description": "The project's name."
                          },
                          "deleteAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the project is gone for good unless it is restored before."
                          },
                          "configVersion": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The project's settings version, which a restore sends as expectedConfigVersion."
                          }
                        },
                        "required": [
                          "conversationId",
                          "name",
                          "deleteAt",
                          "configVersion"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The key's person's projects waiting to be deleted, which can still be restored."
                    }
                  },
                  "required": [
                    "projects"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "projects": [
                    {
                      "conversationId": "9e3b1c75-4f2a-4d86-b0c9-5a7e2d1f8c36",
                      "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73",
                      "name": "Harbor Street kitchen",
                      "deleteAt": "2026-12-21T14:05:00.000Z",
                      "configVersion": 7
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/project-notices": {
      "get": {
        "operationId": "GET /api/v1/account/project-notices",
        "tags": [
          "projects"
        ],
        "summary": "List project deletion notices",
        "description": "The notices of the last 30 days that a project of the key's person was set to be deleted, restored or deleted.\n\nEach notice says it in one line in the reader's language.",
        "x-werk-group": "read",
        "x-werk-area": "projects",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The notices.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "notices": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The notice's id."
                          },
                          "kind": {
                            "type": "string",
                            "enum": [
                              "scheduled",
                              "restored",
                              "deleted"
                            ],
                            "description": "scheduled when the project was set to be deleted, restored when it was brought back, deleted when it is gone."
                          },
                          "projectName": {
                            "type": "string",
                            "description": "The project's name."
                          },
                          "deleteAt": {
                            "anyOf": [
                              {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "When the project is or was to be gone for good, or null."
                          },
                          "createdAt": {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                            "description": "When the notice was made."
                          },
                          "text": {
                            "type": "string",
                            "description": "The notice in one line, in the reader's language."
                          }
                        },
                        "required": [
                          "id",
                          "kind",
                          "projectName",
                          "deleteAt",
                          "createdAt",
                          "text"
                        ],
                        "additionalProperties": false
                      },
                      "description": "Notices to the key's person that a project of theirs was set to be deleted, restored or deleted."
                    }
                  },
                  "required": [
                    "notices"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "notices": [
                    {
                      "id": "d2a6c0e4-9b3f-4d5b-87a9-2b8c0f4d6a08",
                      "kind": "scheduled",
                      "projectName": "Old garage shelves",
                      "deleteAt": "2026-12-10T15:00:00.000Z",
                      "createdAt": "2026-11-10T15:00:00.000Z",
                      "text": "Tom Okafor set Old garage shelves to be deleted on December 10."
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/account/feedback": {
      "post": {
        "operationId": "POST /api/v1/account/feedback",
        "tags": [
          "report"
        ],
        "summary": "Send a report",
        "description": "Sends a report from the key's person to the people who build Werk.\n\nA report is a text or a voice recording, and may name the project it is about. It is kept in Werk's support inbox; nobody in the project is told.",
        "x-werk-group": "create",
        "x-werk-area": "report",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "reportedAt": {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                    "description": "When the report was written, as an ISO 8601 date and time with Z or an offset."
                  },
                  "appVersion": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9 ._+()-]{1,64}$",
                    "description": "The version of the program sending the report."
                  },
                  "text": {
                    "type": "string",
                    "description": "The report, in words; a report has text or audio, never both."
                  },
                  "audio": {
                    "type": "object",
                    "properties": {
                      "assetId": {
                        "type": "string",
                        "format": "uuid",
                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                        "description": "The recording's upload id."
                      }
                    },
                    "required": [
                      "assetId"
                    ],
                    "additionalProperties": false,
                    "description": "A voice recording uploaded first with POST /assets, as the report."
                  },
                  "source": {
                    "type": "string",
                    "const": "assistant",
                    "description": "assistant when an assistant sends the report for the person."
                  },
                  "projectId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The project the report is about."
                  }
                },
                "required": [
                  "clientRequestId",
                  "reportedAt",
                  "appVersion"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a90",
                "reportedAt": "2026-11-21T09:05:00-05:00",
                "appVersion": "harbor-sync 1.4.0",
                "text": "The countertop card shows the old due date after I changed it.",
                "source": "assistant",
                "projectId": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "The report was received.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedbackId": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The report's id."
                    },
                    "status": {
                      "type": "string",
                      "const": "accepted",
                      "description": "Always accepted: the report was received."
                    },
                    "reportedAt": {
                      "type": "string",
                      "format": "date-time",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "description": "When the report says it was written."
                    }
                  },
                  "required": [
                    "feedbackId",
                    "status",
                    "reportedAt"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "feedbackId": "b0e4a8c2-7f1d-4b39-85e7-0f6a8d2b4e86",
                  "status": "accepted",
                  "reportedAt": "2026-11-21T14:05:00.000Z"
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_feedback_detail",
              "invalid_attachment"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "asset_already_submitted"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/list/entries/{entryId}/checked": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/list/entries/:entryId/checked",
        "tags": [
          "cards"
        ],
        "summary": "Check a list item",
        "description": "Checks or unchecks one item of a card's list.\n\nChecking an item already checked changes nothing. expectedRevision and expectedItemVersion are checked only when given.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "entryId",
            "in": "path",
            "required": true,
            "description": "The list item's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "checked": {
                    "type": "boolean",
                    "description": "True checks the item, false unchecks it."
                  },
                  "expectedRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The list's revision as last read; when the list changed since, the change is refused."
                  },
                  "expectedItemVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The card's version as last read; when given and the card changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "checked"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f17",
                "checked": true,
                "expectedRevision": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The list after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checklist": {
                      "type": "object",
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                        },
                        "batches": {
                          "default": [],
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The set's id, which each of its items names as batch."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "authorId": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The person who added the set, or null when no person did."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "description": "When the set was added."
                              },
                              "groupId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id of the change that added the set."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "authorId",
                              "createdAt",
                              "groupId"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The sets of items added together in one change."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The item's id."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The item's place in the list, from 0."
                              },
                              "batch": {
                                "default": null,
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The id of the set the item was added in, or null when it was added on its own."
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The item's text, as written."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The text in the reader's language, when it is written in another."
                              },
                              "checked": {
                                "type": "boolean",
                                "description": "True when the item is checked."
                              },
                              "checkedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the item was checked, or null while it is not."
                              },
                              "checkedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who checked the item, or null while it is not checked."
                              }
                            },
                            "required": [
                              "id",
                              "position",
                              "batch",
                              "text",
                              "checked",
                              "checkedAt",
                              "checkedBy"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The list's items, in their order."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "done": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items checked."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items in all."
                            }
                          },
                          "required": [
                            "done",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The list's items checked and in all."
                        }
                      },
                      "required": [
                        "batches",
                        "items",
                        "counts"
                      ],
                      "additionalProperties": false,
                      "description": "The card's list."
                    }
                  },
                  "required": [
                    "checklist"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "checklist": {
                    "revision": 4,
                    "batches": [
                      {
                        "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "createdAt": "2026-11-19T16:10:00.000Z",
                        "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                      }
                    ],
                    "items": [
                      {
                        "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                        "position": 0,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Shut off the water under the sink",
                        "checked": true,
                        "checkedAt": "2026-11-19T16:20:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        }
                      },
                      {
                        "id": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                        "position": 1,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Pick up the new cartridge",
                        "checked": true,
                        "checkedAt": "2026-11-21T14:05:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Maya Chen",
                          "initials": "MC",
                          "isViewer": true
                        }
                      }
                    ],
                    "counts": {
                      "done": 2,
                      "total": 2
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_checklist_request",
              "empty_text",
              "text_too_long"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "checklist_item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict",
              "revision_conflict",
              "card_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/list/entries": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/list/entries",
        "tags": [
          "cards"
        ],
        "summary": "Add list items",
        "description": "Adds items at the end of a card's list, making the list when the card has none.\n\nA list holds at most 100 items. Refused when the list or the card changed since it was read.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The list's revision as last read; when the list changed since, the change is refused."
                  },
                  "expectedItemVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The card's version as last read; when given and the card changed since, the change is refused."
                  },
                  "texts": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "The new items' texts, added at the end in order."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedRevision",
                  "texts"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f16",
                "expectedRevision": 3,
                "texts": [
                  "Test for leaks"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The list after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checklist": {
                      "type": "object",
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                        },
                        "batches": {
                          "default": [],
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The set's id, which each of its items names as batch."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "authorId": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The person who added the set, or null when no person did."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "description": "When the set was added."
                              },
                              "groupId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id of the change that added the set."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "authorId",
                              "createdAt",
                              "groupId"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The sets of items added together in one change."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The item's id."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The item's place in the list, from 0."
                              },
                              "batch": {
                                "default": null,
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The id of the set the item was added in, or null when it was added on its own."
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The item's text, as written."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The text in the reader's language, when it is written in another."
                              },
                              "checked": {
                                "type": "boolean",
                                "description": "True when the item is checked."
                              },
                              "checkedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the item was checked, or null while it is not."
                              },
                              "checkedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who checked the item, or null while it is not checked."
                              }
                            },
                            "required": [
                              "id",
                              "position",
                              "batch",
                              "text",
                              "checked",
                              "checkedAt",
                              "checkedBy"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The list's items, in their order."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "done": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items checked."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items in all."
                            }
                          },
                          "required": [
                            "done",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The list's items checked and in all."
                        }
                      },
                      "required": [
                        "batches",
                        "items",
                        "counts"
                      ],
                      "additionalProperties": false,
                      "description": "The card's list."
                    }
                  },
                  "required": [
                    "checklist"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "checklist": {
                    "revision": 4,
                    "batches": [
                      {
                        "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "createdAt": "2026-11-19T16:10:00.000Z",
                        "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                      }
                    ],
                    "items": [
                      {
                        "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                        "position": 0,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Shut off the water under the sink",
                        "checked": true,
                        "checkedAt": "2026-11-19T16:20:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        }
                      },
                      {
                        "id": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                        "position": 1,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Pick up the new cartridge",
                        "checked": false,
                        "checkedAt": null,
                        "checkedBy": null
                      },
                      {
                        "id": "a9d3f7b1-6e0c-4a28-b4d6-9e5f7c1a3d75",
                        "position": 2,
                        "batch": null,
                        "text": "Test for leaks",
                        "checked": false,
                        "checkedAt": null,
                        "checkedBy": null
                      }
                    ],
                    "counts": {
                      "done": 1,
                      "total": 3
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_checklist_request",
              "empty_text",
              "text_too_long",
              "too_many_items"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict",
              "card_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/list/entries/{entryId}": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/list/entries/:entryId",
        "tags": [
          "cards"
        ],
        "summary": "Change a list item",
        "description": "Changes the text of one item of a card's list.\n\nRefused when the list or the card changed since it was read.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "entryId",
            "in": "path",
            "required": true,
            "description": "The list item's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The list's revision as last read; when the list changed since, the change is refused."
                  },
                  "expectedItemVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The card's version as last read; when given and the card changed since, the change is refused."
                  },
                  "text": {
                    "type": "string",
                    "description": "The item's new text."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedRevision",
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f18",
                "expectedRevision": 3,
                "text": "Pick up the new faucet"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The list after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checklist": {
                      "type": "object",
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                        },
                        "batches": {
                          "default": [],
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The set's id, which each of its items names as batch."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "authorId": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The person who added the set, or null when no person did."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "description": "When the set was added."
                              },
                              "groupId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id of the change that added the set."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "authorId",
                              "createdAt",
                              "groupId"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The sets of items added together in one change."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The item's id."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The item's place in the list, from 0."
                              },
                              "batch": {
                                "default": null,
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The id of the set the item was added in, or null when it was added on its own."
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The item's text, as written."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The text in the reader's language, when it is written in another."
                              },
                              "checked": {
                                "type": "boolean",
                                "description": "True when the item is checked."
                              },
                              "checkedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the item was checked, or null while it is not."
                              },
                              "checkedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who checked the item, or null while it is not checked."
                              }
                            },
                            "required": [
                              "id",
                              "position",
                              "batch",
                              "text",
                              "checked",
                              "checkedAt",
                              "checkedBy"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The list's items, in their order."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "done": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items checked."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items in all."
                            }
                          },
                          "required": [
                            "done",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The list's items checked and in all."
                        }
                      },
                      "required": [
                        "batches",
                        "items",
                        "counts"
                      ],
                      "additionalProperties": false,
                      "description": "The card's list."
                    }
                  },
                  "required": [
                    "checklist"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "checklist": {
                    "revision": 4,
                    "batches": [
                      {
                        "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "createdAt": "2026-11-19T16:10:00.000Z",
                        "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                      }
                    ],
                    "items": [
                      {
                        "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                        "position": 0,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Shut off the water under the sink",
                        "checked": true,
                        "checkedAt": "2026-11-19T16:20:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        }
                      },
                      {
                        "id": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                        "position": 1,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Pick up the new faucet",
                        "checked": false,
                        "checkedAt": null,
                        "checkedBy": null
                      }
                    ],
                    "counts": {
                      "done": 1,
                      "total": 2
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_checklist_request",
              "empty_text",
              "text_too_long"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict",
              "card_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "delete": {
        "operationId": "DELETE /api/v1/projects/:projectId/cards/:cardId/list/entries/:entryId",
        "tags": [
          "cards"
        ],
        "summary": "Remove a list item",
        "description": "Takes one item off a card's list.\n\nAn item that is not on the list is refused. Refused also when the list or the card changed since it was read.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "entryId",
            "in": "path",
            "required": true,
            "description": "The list item's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The list's revision as last read; when the list changed since, the change is refused."
                  },
                  "expectedItemVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The card's version as last read; when given and the card changed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedRevision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f19",
                "expectedRevision": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The list after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checklist": {
                      "type": "object",
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                        },
                        "batches": {
                          "default": [],
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The set's id, which each of its items names as batch."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "authorId": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The person who added the set, or null when no person did."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "description": "When the set was added."
                              },
                              "groupId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id of the change that added the set."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "authorId",
                              "createdAt",
                              "groupId"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The sets of items added together in one change."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The item's id."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The item's place in the list, from 0."
                              },
                              "batch": {
                                "default": null,
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The id of the set the item was added in, or null when it was added on its own."
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The item's text, as written."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The text in the reader's language, when it is written in another."
                              },
                              "checked": {
                                "type": "boolean",
                                "description": "True when the item is checked."
                              },
                              "checkedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the item was checked, or null while it is not."
                              },
                              "checkedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who checked the item, or null while it is not checked."
                              }
                            },
                            "required": [
                              "id",
                              "position",
                              "batch",
                              "text",
                              "checked",
                              "checkedAt",
                              "checkedBy"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The list's items, in their order."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "done": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items checked."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items in all."
                            }
                          },
                          "required": [
                            "done",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The list's items checked and in all."
                        }
                      },
                      "required": [
                        "batches",
                        "items",
                        "counts"
                      ],
                      "additionalProperties": false,
                      "description": "The card's list."
                    }
                  },
                  "required": [
                    "checklist"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "checklist": {
                    "revision": 4,
                    "batches": [
                      {
                        "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "createdAt": "2026-11-19T16:10:00.000Z",
                        "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                      }
                    ],
                    "items": [
                      {
                        "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                        "position": 0,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Shut off the water under the sink",
                        "checked": true,
                        "checkedAt": "2026-11-19T16:20:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        }
                      }
                    ],
                    "counts": {
                      "done": 1,
                      "total": 1
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_checklist_request",
              "empty_text",
              "text_too_long"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict",
              "card_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/list/order": {
      "put": {
        "operationId": "PUT /api/v1/projects/:projectId/cards/:cardId/list/order",
        "tags": [
          "cards"
        ],
        "summary": "Reorder a list",
        "description": "Moves one item of a card's list to another place.\n\nThe order sent is every item of the list with one of them moved. Refused when the list or the card changed since it was read.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The list's revision as last read; when the list changed since, the change is refused."
                  },
                  "expectedItemVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The card's version as last read; when given and the card changed since, the change is refused."
                  },
                  "orderedIds": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                    },
                    "description": "Every item's id in the new order: the list with one item moved."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedRevision",
                  "orderedIds"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4f20",
                "expectedRevision": 3,
                "orderedIds": [
                  "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                  "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The list after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "checklist": {
                      "type": "object",
                      "properties": {
                        "revision": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The list's revision, which grows with every change to it; a change to the list sends it as expectedRevision."
                        },
                        "batches": {
                          "default": [],
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The set's id, which each of its items names as batch."
                              },
                              "itemId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The card's id."
                              },
                              "authorId": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The person who added the set, or null when no person did."
                              },
                              "createdAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "description": "When the set was added."
                              },
                              "groupId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The id of the change that added the set."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "authorId",
                              "createdAt",
                              "groupId"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The sets of items added together in one change."
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The item's id."
                              },
                              "position": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The item's place in the list, from 0."
                              },
                              "batch": {
                                "default": null,
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The id of the set the item was added in, or null when it was added on its own."
                              },
                              "text": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The item's text, as written."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "The text in the reader's language, when it is written in another."
                              },
                              "checked": {
                                "type": "boolean",
                                "description": "True when the item is checked."
                              },
                              "checkedAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the item was checked, or null while it is not."
                              },
                              "checkedBy": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "user",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "displayName": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The person's name as the project shows it."
                                          },
                                          "initials": {
                                            "type": "string",
                                            "description": "The person's initials, for an avatar with no photo."
                                          },
                                          "isViewer": {
                                            "type": "boolean",
                                            "description": "True when the person is the key's own person."
                                          },
                                          "photo": {
                                            "type": "object",
                                            "properties": {
                                              "personId": {
                                                "type": "string",
                                                "format": "uuid",
                                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                                "description": "The person whose photo it is."
                                              },
                                              "version": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                              }
                                            },
                                            "required": [
                                              "personId",
                                              "version"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The person's photo, when they have one."
                                          },
                                          "via": {
                                            "type": "object",
                                            "properties": {
                                              "kind": {
                                                "type": "string",
                                                "enum": [
                                                  "connection",
                                                  "key"
                                                ],
                                                "description": "connection for an app connected by sign-in, key for an API key."
                                              },
                                              "name": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The app's or the key's name, as Werk shows it."
                                              },
                                              "verified": {
                                                "type": "boolean",
                                                "description": "True when Werk verified the app's identity."
                                              },
                                              "label": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The caption Werk shows beside the change, in the reader's language."
                                              }
                                            },
                                            "required": [
                                              "kind",
                                              "name",
                                              "verified",
                                              "label"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The connected app or API key the change came through; absent for a change made in Werk's apps."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "displayName",
                                          "initials",
                                          "isViewer"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "connector",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "kind": {
                                            "type": "string",
                                            "const": "schedule",
                                            "description": "user for a person; connector or schedule for a change Werk made without one."
                                          },
                                          "label": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The name Werk shows for a change made without a person."
                                          }
                                        },
                                        "required": [
                                          "kind",
                                          "label"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "Who checked the item, or null while it is not checked."
                              }
                            },
                            "required": [
                              "id",
                              "position",
                              "batch",
                              "text",
                              "checked",
                              "checkedAt",
                              "checkedBy"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The list's items, in their order."
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "done": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items checked."
                            },
                            "total": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "List items in all."
                            }
                          },
                          "required": [
                            "done",
                            "total"
                          ],
                          "additionalProperties": false,
                          "description": "The list's items checked and in all."
                        }
                      },
                      "required": [
                        "batches",
                        "items",
                        "counts"
                      ],
                      "additionalProperties": false,
                      "description": "The card's list."
                    }
                  },
                  "required": [
                    "checklist"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "checklist": {
                    "revision": 4,
                    "batches": [
                      {
                        "id": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                        "authorId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                        "createdAt": "2026-11-19T16:10:00.000Z",
                        "groupId": "d7b1f5c9-0e4a-4bc6-98fa-6c2e4a9b3d51"
                      }
                    ],
                    "items": [
                      {
                        "id": "b5f9d3a7-8c2e-4fa4-b6d8-4a0c2e7f1b39",
                        "position": 0,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Pick up the new cartridge",
                        "checked": false,
                        "checkedAt": null,
                        "checkedBy": null
                      },
                      {
                        "id": "a4e8c2f6-7b1d-4e93-a5c7-3f9b1d6e0a28",
                        "position": 1,
                        "batch": "c6a0e4b8-9d3f-4ab5-87e9-5b1d3f8a2c40",
                        "text": "Shut off the water under the sink",
                        "checked": true,
                        "checkedAt": "2026-11-19T16:20:00.000Z",
                        "checkedBy": {
                          "kind": "user",
                          "displayName": "Tom Okafor",
                          "initials": "TO",
                          "isViewer": false
                        }
                      }
                    ],
                    "counts": {
                      "done": 1,
                      "total": 2
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_checklist_request",
              "empty_text",
              "text_too_long",
              "order_mismatch"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "not_permitted"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "item_version_conflict",
              "card_archived"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/reminders": {
      "get": {
        "operationId": "GET /api/v1/reminders",
        "tags": [
          "reminders"
        ],
        "summary": "List cardless reminders",
        "description": "The key's person's reminders that are on no card, kept in their own project, My Werk.\n\nSoonest first. When the key's person has no My Werk, or it is archived or being deleted, the answer is kind unavailable instead of a list.",
        "x-werk-group": "read",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The cursor from the previous page's nextCursor; left out, the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "How many reminders a page holds.",
            "schema": {
              "default": 100,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": "20"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The reminders, or kind unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "ready",
                          "description": "ready with the list; unavailable when the key's person has no My Werk to hold such reminders now."
                        },
                        "projectId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The id of the key's person's own project, My Werk, which holds reminders with no card."
                        },
                        "conversationId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The id Werk's apps use for the key's person's view of the project; the API's paths take projectId."
                        },
                        "title": {
                          "type": "string",
                          "description": "The name My Werk shows over the list, in the reader's language."
                        },
                        "reminders": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The reminder's id."
                              },
                              "itemId": {
                                "type": "null",
                                "description": "Always null: this reminder has no card."
                              },
                              "version": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                              },
                              "timeRevision": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                              },
                              "snoozeRevision": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                              },
                              "fireAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The time its owner set the reminder for."
                              },
                              "effectiveFireAt": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                              },
                              "snoozedUntil": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "format": "date-time",
                                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "The time the key's person snoozed the reminder to, or null."
                              },
                              "setterTimeZone": {
                                "type": "string",
                                "description": "The time zone the reminder's time was set in."
                              },
                              "text": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "The reminder's text, as its owner wrote it."
                              },
                              "language": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 64,
                                "description": "The language a shared reminder's text is written in."
                              },
                              "translation": {
                                "type": "object",
                                "properties": {
                                  "language": {
                                    "type": "string",
                                    "minLength": 2,
                                    "maxLength": 64,
                                    "description": "The reader's language the text is translated into."
                                  },
                                  "state": {
                                    "type": "string",
                                    "enum": [
                                      "ready",
                                      "pending",
                                      "failed",
                                      "paused"
                                    ],
                                    "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "The translated text, present once ready."
                                  }
                                },
                                "required": [
                                  "language",
                                  "state"
                                ],
                                "additionalProperties": false,
                                "description": "A shared reminder's text in the reader's language, when it is written in another."
                              },
                              "state": {
                                "type": "string",
                                "enum": [
                                  "upcoming",
                                  "past",
                                  "dropped"
                                ],
                                "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                              },
                              "audience": {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "only_you",
                                    "description": "Always only_you: a reminder with no card is never shared."
                                  },
                                  "label": {
                                    "type": "string",
                                    "description": "Who the reminder is for, in one line in the reader's language."
                                  },
                                  "owner": {
                                    "type": "object",
                                    "properties": {
                                      "userId": {
                                        "type": "string",
                                        "format": "uuid",
                                        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                        "description": "The person's id."
                                      },
                                      "displayName": {
                                        "type": "string",
                                        "description": "The person's name as the project shows it."
                                      },
                                      "initials": {
                                        "type": "string",
                                        "description": "The person's initials, for an avatar with no photo."
                                      },
                                      "isViewer": {
                                        "type": "boolean",
                                        "description": "True when the person is the key's own person."
                                      },
                                      "photo": {
                                        "type": "object",
                                        "properties": {
                                          "personId": {
                                            "type": "string",
                                            "format": "uuid",
                                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                            "description": "The person whose photo it is."
                                          },
                                          "version": {
                                            "type": "integer",
                                            "exclusiveMinimum": 0,
                                            "maximum": 9007199254740991,
                                            "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                          }
                                        },
                                        "required": [
                                          "personId",
                                          "version"
                                        ],
                                        "additionalProperties": false,
                                        "description": "The person's photo, when they have one."
                                      }
                                    },
                                    "required": [
                                      "userId",
                                      "displayName",
                                      "initials",
                                      "isViewer"
                                    ],
                                    "additionalProperties": false,
                                    "description": "The person who set the reminder."
                                  },
                                  "invited": {
                                    "minItems": 0,
                                    "maxItems": 0,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "userId": {
                                          "type": "string",
                                          "format": "uuid",
                                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                          "description": "The person's id."
                                        },
                                        "displayName": {
                                          "type": "string",
                                          "description": "The person's name as the project shows it."
                                        },
                                        "initials": {
                                          "type": "string",
                                          "description": "The person's initials, for an avatar with no photo."
                                        },
                                        "isViewer": {
                                          "type": "boolean",
                                          "description": "True when the person is the key's own person."
                                        },
                                        "photo": {
                                          "type": "object",
                                          "properties": {
                                            "personId": {
                                              "type": "string",
                                              "format": "uuid",
                                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                              "description": "The person whose photo it is."
                                            },
                                            "version": {
                                              "type": "integer",
                                              "exclusiveMinimum": 0,
                                              "maximum": 9007199254740991,
                                              "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                            }
                                          },
                                          "required": [
                                            "personId",
                                            "version"
                                          ],
                                          "additionalProperties": false,
                                          "description": "The person's photo, when they have one."
                                        }
                                      },
                                      "required": [
                                        "userId",
                                        "displayName",
                                        "initials",
                                        "isViewer"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "description": "Always empty: a reminder with no card is never shared."
                                  }
                                },
                                "required": [
                                  "kind",
                                  "label",
                                  "owner",
                                  "invited"
                                ],
                                "additionalProperties": false,
                                "description": "Whose reminder it is and who it is shared with."
                              },
                              "quotedReminderRef": {
                                "type": "null",
                                "description": "Always null for a reminder with no card."
                              },
                              "actions": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "const": "delete"
                                },
                                "description": "What the key's person may do with the reminder now."
                              }
                            },
                            "required": [
                              "id",
                              "itemId",
                              "version",
                              "timeRevision",
                              "snoozeRevision",
                              "fireAt",
                              "effectiveFireAt",
                              "snoozedUntil",
                              "setterTimeZone",
                              "text",
                              "state",
                              "audience",
                              "quotedReminderRef",
                              "actions"
                            ],
                            "additionalProperties": false
                          },
                          "description": "The reminders on this page, soonest first."
                        },
                        "hasMore": {
                          "type": "boolean",
                          "description": "True when more reminders remain past this page."
                        },
                        "nextCursor": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "The cursor that reads the next page as after, or null when none remains."
                        }
                      },
                      "required": [
                        "kind",
                        "projectId",
                        "conversationId",
                        "title",
                        "reminders",
                        "hasMore",
                        "nextCursor"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "unavailable",
                          "description": "ready with the list; unavailable when the key's person has no My Werk to hold such reminders now."
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "kind": "ready",
                  "projectId": "0c5e7a29-3d1b-4e86-b4f2-8a9c1d6e3b50",
                  "conversationId": "5a1c8e37-2b9d-4f64-a0e3-7d2f5c8b1e96",
                  "title": "My Werk",
                  "reminders": [
                    {
                      "id": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17",
                      "itemId": null,
                      "version": 1,
                      "timeRevision": 1,
                      "snoozeRevision": 0,
                      "fireAt": "2026-11-28T14:00:00.000Z",
                      "effectiveFireAt": "2026-11-28T14:00:00.000Z",
                      "snoozedUntil": null,
                      "setterTimeZone": "America/New_York",
                      "text": "Renew the van insurance",
                      "state": "upcoming",
                      "audience": {
                        "kind": "only_you",
                        "label": "Only you",
                        "owner": {
                          "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                          "displayName": "Maya Chen",
                          "initials": "MC",
                          "isViewer": true
                        },
                        "invited": []
                      },
                      "quotedReminderRef": null,
                      "actions": [
                        "delete"
                      ]
                    }
                  ],
                  "hasMore": false,
                  "nextCursor": null
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_limit"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "cursor_expired"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "post": {
        "operationId": "POST /api/v1/reminders",
        "tags": [
          "reminders"
        ],
        "summary": "Create a cardless reminder",
        "description": "Sets a reminder on no card for the key's person, kept in their My Werk.\n\nIt goes off at its time for the key's person alone. A time that is not in the future is refused.",
        "x-werk-group": "create",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "at": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                    "description": "When the reminder goes off, as an ISO 8601 date and time with Z or an offset."
                  },
                  "text": {
                    "type": "string",
                    "description": "What the reminder is for, in its owner's words."
                  }
                },
                "required": [
                  "clientRequestId",
                  "at",
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a01",
                "at": "2026-11-28T09:00:00-05:00",
                "text": "Renew the van insurance"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The new reminder.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The reminder's id."
                    },
                    "itemId": {
                      "type": "null",
                      "description": "Always null: this reminder has no card."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                    },
                    "timeRevision": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                    },
                    "snoozeRevision": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                    },
                    "fireAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The time its owner set the reminder for."
                    },
                    "effectiveFireAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                    },
                    "snoozedUntil": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The time the key's person snoozed the reminder to, or null."
                    },
                    "setterTimeZone": {
                      "type": "string",
                      "description": "The time zone the reminder's time was set in."
                    },
                    "text": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The reminder's text, as its owner wrote it."
                    },
                    "language": {
                      "type": "string",
                      "minLength": 2,
                      "maxLength": 64,
                      "description": "The language a shared reminder's text is written in."
                    },
                    "translation": {
                      "type": "object",
                      "properties": {
                        "language": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 64,
                          "description": "The reader's language the text is translated into."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "pending",
                            "failed",
                            "paused"
                          ],
                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                        },
                        "text": {
                          "type": "string",
                          "description": "The translated text, present once ready."
                        }
                      },
                      "required": [
                        "language",
                        "state"
                      ],
                      "additionalProperties": false,
                      "description": "A shared reminder's text in the reader's language, when it is written in another."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "upcoming",
                        "past",
                        "dropped"
                      ],
                      "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                    },
                    "audience": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "only_you",
                          "description": "Always only_you: a reminder with no card is never shared."
                        },
                        "label": {
                          "type": "string",
                          "description": "Who the reminder is for, in one line in the reader's language."
                        },
                        "owner": {
                          "type": "object",
                          "properties": {
                            "userId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person's id."
                            },
                            "displayName": {
                              "type": "string",
                              "description": "The person's name as the project shows it."
                            },
                            "initials": {
                              "type": "string",
                              "description": "The person's initials, for an avatar with no photo."
                            },
                            "isViewer": {
                              "type": "boolean",
                              "description": "True when the person is the key's own person."
                            },
                            "photo": {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person whose photo it is."
                                },
                                "version": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "personId",
                                "version"
                              ],
                              "additionalProperties": false,
                              "description": "The person's photo, when they have one."
                            }
                          },
                          "required": [
                            "userId",
                            "displayName",
                            "initials",
                            "isViewer"
                          ],
                          "additionalProperties": false,
                          "description": "The person who set the reminder."
                        },
                        "invited": {
                          "minItems": 0,
                          "maxItems": 0,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "userId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "displayName": {
                                "type": "string",
                                "description": "The person's name as the project shows it."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "isViewer": {
                                "type": "boolean",
                                "description": "True when the person is the key's own person."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "userId",
                              "displayName",
                              "initials",
                              "isViewer"
                            ],
                            "additionalProperties": false
                          },
                          "description": "Always empty: a reminder with no card is never shared."
                        }
                      },
                      "required": [
                        "kind",
                        "label",
                        "owner",
                        "invited"
                      ],
                      "additionalProperties": false,
                      "description": "Whose reminder it is and who it is shared with."
                    },
                    "quotedReminderRef": {
                      "type": "null",
                      "description": "Always null for a reminder with no card."
                    },
                    "actions": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "delete"
                      },
                      "description": "What the key's person may do with the reminder now."
                    }
                  },
                  "required": [
                    "id",
                    "itemId",
                    "version",
                    "timeRevision",
                    "snoozeRevision",
                    "fireAt",
                    "effectiveFireAt",
                    "snoozedUntil",
                    "setterTimeZone",
                    "text",
                    "state",
                    "audience",
                    "quotedReminderRef",
                    "actions"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "id": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17",
                  "itemId": null,
                  "version": 1,
                  "timeRevision": 1,
                  "snoozeRevision": 0,
                  "fireAt": "2026-11-28T14:00:00.000Z",
                  "effectiveFireAt": "2026-11-28T14:00:00.000Z",
                  "snoozedUntil": null,
                  "setterTimeZone": "America/New_York",
                  "text": "Renew the van insurance",
                  "state": "upcoming",
                  "audience": {
                    "kind": "only_you",
                    "label": "Only you",
                    "owner": {
                      "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC",
                      "isViewer": true
                    },
                    "invited": []
                  },
                  "quotedReminderRef": null,
                  "actions": [
                    "delete"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message",
              "empty_text",
              "personal_reminder_text_too_long",
              "personal_project_unavailable",
              "personal_reminder_invalid_time"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "item_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "personal_reminder_source_expired"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/reminders/{reminderId}": {
      "get": {
        "operationId": "GET /api/v1/reminders/:reminderId",
        "tags": [
          "reminders"
        ],
        "summary": "Get a cardless reminder",
        "description": "One of the key's person's reminders that are on no card.\n\nA reminder on a card is read under its card instead.",
        "x-werk-group": "read",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The reminder.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The reminder's id."
                    },
                    "itemId": {
                      "type": "null",
                      "description": "Always null: this reminder has no card."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                    },
                    "timeRevision": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                    },
                    "snoozeRevision": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                    },
                    "fireAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The time its owner set the reminder for."
                    },
                    "effectiveFireAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                    },
                    "snoozedUntil": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The time the key's person snoozed the reminder to, or null."
                    },
                    "setterTimeZone": {
                      "type": "string",
                      "description": "The time zone the reminder's time was set in."
                    },
                    "text": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The reminder's text, as its owner wrote it."
                    },
                    "language": {
                      "type": "string",
                      "minLength": 2,
                      "maxLength": 64,
                      "description": "The language a shared reminder's text is written in."
                    },
                    "translation": {
                      "type": "object",
                      "properties": {
                        "language": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 64,
                          "description": "The reader's language the text is translated into."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "pending",
                            "failed",
                            "paused"
                          ],
                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                        },
                        "text": {
                          "type": "string",
                          "description": "The translated text, present once ready."
                        }
                      },
                      "required": [
                        "language",
                        "state"
                      ],
                      "additionalProperties": false,
                      "description": "A shared reminder's text in the reader's language, when it is written in another."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "upcoming",
                        "past",
                        "dropped"
                      ],
                      "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                    },
                    "audience": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "only_you",
                          "description": "Always only_you: a reminder with no card is never shared."
                        },
                        "label": {
                          "type": "string",
                          "description": "Who the reminder is for, in one line in the reader's language."
                        },
                        "owner": {
                          "type": "object",
                          "properties": {
                            "userId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person's id."
                            },
                            "displayName": {
                              "type": "string",
                              "description": "The person's name as the project shows it."
                            },
                            "initials": {
                              "type": "string",
                              "description": "The person's initials, for an avatar with no photo."
                            },
                            "isViewer": {
                              "type": "boolean",
                              "description": "True when the person is the key's own person."
                            },
                            "photo": {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person whose photo it is."
                                },
                                "version": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "personId",
                                "version"
                              ],
                              "additionalProperties": false,
                              "description": "The person's photo, when they have one."
                            }
                          },
                          "required": [
                            "userId",
                            "displayName",
                            "initials",
                            "isViewer"
                          ],
                          "additionalProperties": false,
                          "description": "The person who set the reminder."
                        },
                        "invited": {
                          "minItems": 0,
                          "maxItems": 0,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "userId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "displayName": {
                                "type": "string",
                                "description": "The person's name as the project shows it."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "isViewer": {
                                "type": "boolean",
                                "description": "True when the person is the key's own person."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "userId",
                              "displayName",
                              "initials",
                              "isViewer"
                            ],
                            "additionalProperties": false
                          },
                          "description": "Always empty: a reminder with no card is never shared."
                        }
                      },
                      "required": [
                        "kind",
                        "label",
                        "owner",
                        "invited"
                      ],
                      "additionalProperties": false,
                      "description": "Whose reminder it is and who it is shared with."
                    },
                    "quotedReminderRef": {
                      "type": "null",
                      "description": "Always null for a reminder with no card."
                    },
                    "actions": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "delete"
                      },
                      "description": "What the key's person may do with the reminder now."
                    }
                  },
                  "required": [
                    "id",
                    "itemId",
                    "version",
                    "timeRevision",
                    "snoozeRevision",
                    "fireAt",
                    "effectiveFireAt",
                    "snoozedUntil",
                    "setterTimeZone",
                    "text",
                    "state",
                    "audience",
                    "quotedReminderRef",
                    "actions"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "id": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17",
                  "itemId": null,
                  "version": 1,
                  "timeRevision": 1,
                  "snoozeRevision": 0,
                  "fireAt": "2026-11-28T14:00:00.000Z",
                  "effectiveFireAt": "2026-11-28T14:00:00.000Z",
                  "snoozedUntil": null,
                  "setterTimeZone": "America/New_York",
                  "text": "Renew the van insurance",
                  "state": "upcoming",
                  "audience": {
                    "kind": "only_you",
                    "label": "Only you",
                    "owner": {
                      "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC",
                      "isViewer": true
                    },
                    "invited": []
                  },
                  "quotedReminderRef": null,
                  "actions": [
                    "delete"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "put": {
        "operationId": "PUT /api/v1/reminders/:reminderId",
        "tags": [
          "reminders"
        ],
        "summary": "Change a cardless reminder",
        "description": "Changes the time or the text of one of the key's person's reminders on no card.\n\nWhat is left out stays. The change is refused when the reminder changed or was snoozed since it was read.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the change is refused."
                  },
                  "expectedTimeRevision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's timeRevision as last read; when its time changed since, the change is refused."
                  },
                  "expectedSnoozeRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's snoozeRevision as last read; when it was snoozed since, the change is refused."
                  },
                  "at": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:\\d{2}))?$",
                    "description": "The new time, as an ISO 8601 date and time with Z or an offset; left out, it stays."
                  },
                  "text": {
                    "type": "string",
                    "description": "The new text; left out, it stays."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "expectedTimeRevision",
                  "expectedSnoozeRevision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a02",
                "expectedVersion": 1,
                "expectedTimeRevision": 1,
                "expectedSnoozeRevision": 0,
                "text": "Renew the van and trailer insurance"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The reminder after the change.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The reminder's id."
                    },
                    "itemId": {
                      "type": "null",
                      "description": "Always null: this reminder has no card."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The reminder's version, which grows with every change to it; a change sends it as expectedVersion."
                    },
                    "timeRevision": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Grows each time the reminder's time changes; a change sends it as expectedTimeRevision."
                    },
                    "snoozeRevision": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Grows each time the key's person snoozes the reminder; a change sends it as expectedSnoozeRevision."
                    },
                    "fireAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The time its owner set the reminder for."
                    },
                    "effectiveFireAt": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When the reminder goes off for the key's person: the snoozed time, else the set time."
                    },
                    "snoozedUntil": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The time the key's person snoozed the reminder to, or null."
                    },
                    "setterTimeZone": {
                      "type": "string",
                      "description": "The time zone the reminder's time was set in."
                    },
                    "text": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The reminder's text, as its owner wrote it."
                    },
                    "language": {
                      "type": "string",
                      "minLength": 2,
                      "maxLength": 64,
                      "description": "The language a shared reminder's text is written in."
                    },
                    "translation": {
                      "type": "object",
                      "properties": {
                        "language": {
                          "type": "string",
                          "minLength": 2,
                          "maxLength": 64,
                          "description": "The reader's language the text is translated into."
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "pending",
                            "failed",
                            "paused"
                          ],
                          "description": "ready when text holds the translation, pending while it is being made, failed when it could not be made, paused when no plan pays for translations now."
                        },
                        "text": {
                          "type": "string",
                          "description": "The translated text, present once ready."
                        }
                      },
                      "required": [
                        "language",
                        "state"
                      ],
                      "additionalProperties": false,
                      "description": "A shared reminder's text in the reader's language, when it is written in another."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "upcoming",
                        "past",
                        "dropped"
                      ],
                      "description": "upcoming before it goes off, past once it went off, dropped when it will not go off, its card done, archived or out of reach."
                    },
                    "audience": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "only_you",
                          "description": "Always only_you: a reminder with no card is never shared."
                        },
                        "label": {
                          "type": "string",
                          "description": "Who the reminder is for, in one line in the reader's language."
                        },
                        "owner": {
                          "type": "object",
                          "properties": {
                            "userId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person's id."
                            },
                            "displayName": {
                              "type": "string",
                              "description": "The person's name as the project shows it."
                            },
                            "initials": {
                              "type": "string",
                              "description": "The person's initials, for an avatar with no photo."
                            },
                            "isViewer": {
                              "type": "boolean",
                              "description": "True when the person is the key's own person."
                            },
                            "photo": {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person whose photo it is."
                                },
                                "version": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "personId",
                                "version"
                              ],
                              "additionalProperties": false,
                              "description": "The person's photo, when they have one."
                            }
                          },
                          "required": [
                            "userId",
                            "displayName",
                            "initials",
                            "isViewer"
                          ],
                          "additionalProperties": false,
                          "description": "The person who set the reminder."
                        },
                        "invited": {
                          "minItems": 0,
                          "maxItems": 0,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "userId": {
                                "type": "string",
                                "format": "uuid",
                                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                "description": "The person's id."
                              },
                              "displayName": {
                                "type": "string",
                                "description": "The person's name as the project shows it."
                              },
                              "initials": {
                                "type": "string",
                                "description": "The person's initials, for an avatar with no photo."
                              },
                              "isViewer": {
                                "type": "boolean",
                                "description": "True when the person is the key's own person."
                              },
                              "photo": {
                                "type": "object",
                                "properties": {
                                  "personId": {
                                    "type": "string",
                                    "format": "uuid",
                                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                    "description": "The person whose photo it is."
                                  },
                                  "version": {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991,
                                    "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                  }
                                },
                                "required": [
                                  "personId",
                                  "version"
                                ],
                                "additionalProperties": false,
                                "description": "The person's photo, when they have one."
                              }
                            },
                            "required": [
                              "userId",
                              "displayName",
                              "initials",
                              "isViewer"
                            ],
                            "additionalProperties": false
                          },
                          "description": "Always empty: a reminder with no card is never shared."
                        }
                      },
                      "required": [
                        "kind",
                        "label",
                        "owner",
                        "invited"
                      ],
                      "additionalProperties": false,
                      "description": "Whose reminder it is and who it is shared with."
                    },
                    "quotedReminderRef": {
                      "type": "null",
                      "description": "Always null for a reminder with no card."
                    },
                    "actions": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "const": "delete"
                      },
                      "description": "What the key's person may do with the reminder now."
                    }
                  },
                  "required": [
                    "id",
                    "itemId",
                    "version",
                    "timeRevision",
                    "snoozeRevision",
                    "fireAt",
                    "effectiveFireAt",
                    "snoozedUntil",
                    "setterTimeZone",
                    "text",
                    "state",
                    "audience",
                    "quotedReminderRef",
                    "actions"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "id": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17",
                  "itemId": null,
                  "version": 2,
                  "timeRevision": 1,
                  "snoozeRevision": 0,
                  "fireAt": "2026-11-28T14:00:00.000Z",
                  "effectiveFireAt": "2026-11-28T14:00:00.000Z",
                  "snoozedUntil": null,
                  "setterTimeZone": "America/New_York",
                  "text": "Renew the van and trailer insurance",
                  "state": "upcoming",
                  "audience": {
                    "kind": "only_you",
                    "label": "Only you",
                    "owner": {
                      "userId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
                      "displayName": "Maya Chen",
                      "initials": "MC",
                      "isViewer": true
                    },
                    "invited": []
                  },
                  "quotedReminderRef": null,
                  "actions": [
                    "delete"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message",
              "empty_text",
              "personal_reminder_text_too_long",
              "invalid_card_query",
              "personal_reminder_invalid_time"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "actor_not_allowed",
              "personal_reminder_not_owner"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "item_not_found",
              "not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale",
              "personal_reminder_source_expired"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      },
      "delete": {
        "operationId": "DELETE /api/v1/reminders/:reminderId",
        "tags": [
          "reminders"
        ],
        "summary": "Delete a cardless reminder",
        "description": "Deletes one of the key's person's reminders on no card.\n\nRefused when the reminder changed or was snoozed since it was read. When the key's person has no My Werk now, the answer is kind unavailable and nothing changes.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the change is refused."
                  },
                  "expectedTimeRevision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's timeRevision as last read; when its time changed since, the change is refused."
                  },
                  "expectedSnoozeRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's snoozeRevision as last read; when it was snoozed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "expectedTimeRevision",
                  "expectedSnoozeRevision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a03",
                "expectedVersion": 1,
                "expectedTimeRevision": 1,
                "expectedSnoozeRevision": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the request did.",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "applied",
                            "unchanged"
                          ],
                          "description": "applied when the reminder was deleted, unchanged when it already was, unavailable when the key's person has no My Werk now."
                        },
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The id of the thing changed."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "Its version after the request."
                        }
                      },
                      "required": [
                        "kind",
                        "id",
                        "version"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "unavailable",
                          "description": "applied when the reminder was deleted, unchanged when it already was, unavailable when the key's person has no My Werk now."
                        }
                      },
                      "required": [
                        "kind"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "kind": "applied",
                  "id": "4d8a1e63-9b2c-4f57-8e0d-2c6b5a9f3e17",
                  "version": 2
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_reminder_not_owner"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "item_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/reminders/{reminderId}/remove": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/reminders/:reminderId/remove",
        "tags": [
          "reminders"
        ],
        "summary": "Remove a shared reminder",
        "description": "Takes a reminder someone shared with the key's person off their own list.\n\nThe reminder stays its owner's, who is not told. The key's person's own reminders are deleted instead.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81"
          },
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "8f3b7d1a-2c6e-4a95-b0d4-7e1a5c9f3b62"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the change is refused."
                  },
                  "expectedTimeRevision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's timeRevision as last read; when its time changed since, the change is refused."
                  },
                  "expectedSnoozeRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's snoozeRevision as last read; when it was snoozed since, the change is refused."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "expectedTimeRevision",
                  "expectedSnoozeRevision"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a08",
                "expectedVersion": 1,
                "expectedTimeRevision": 1,
                "expectedSnoozeRevision": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the request did.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "applied",
                        "unchanged"
                      ],
                      "description": "applied when the change was made, unchanged when it already held."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id of the thing changed."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Its version after the request."
                    }
                  },
                  "required": [
                    "kind",
                    "id",
                    "version"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "kind": "applied",
                  "id": "8f3b7d1a-2c6e-4a95-b0d4-7e1a5c9f3b62",
                  "version": 2
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_reminder_not_owner"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/reminders/{reminderId}/snooze": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/reminders/:reminderId/snooze",
        "tags": [
          "reminders"
        ],
        "summary": "Snooze a reminder",
        "description": "Moves when a reminder on a card goes off for the key's person: an hour from now, or tomorrow.\n\nIt works on their own reminders and on ones shared with them, and changes the time for them alone.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "reminderId",
            "in": "path",
            "required": true,
            "description": "The reminder's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's version as last read; when it changed since, the change is refused."
                  },
                  "expectedTimeRevision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's timeRevision as last read; when its time changed since, the change is refused."
                  },
                  "expectedSnoozeRevision": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The reminder's snoozeRevision as last read; when it was snoozed since, the change is refused."
                  },
                  "option": {
                    "type": "string",
                    "enum": [
                      "hour",
                      "tomorrow"
                    ],
                    "description": "hour snoozes it one hour from now; tomorrow, to tomorrow at the time of the key's person's daily brief."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "expectedTimeRevision",
                  "expectedSnoozeRevision",
                  "option"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a09",
                "expectedVersion": 1,
                "expectedTimeRevision": 1,
                "expectedSnoozeRevision": 0,
                "option": "hour"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the request did.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "applied",
                        "unchanged"
                      ],
                      "description": "applied when the change was made, unchanged when it already held."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id of the thing changed."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Its version after the request."
                    }
                  },
                  "required": [
                    "kind",
                    "id",
                    "version"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "kind": "applied",
                  "id": "7b4f2c91-5e8a-4d36-9a1c-3e7d0b5f2c84",
                  "version": 1
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message",
              "personal_reminder_invalid_time"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "personal_reminder_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_stale"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/reminder-invitations/{invitationId}": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/reminder-invitations/:invitationId",
        "tags": [
          "reminders"
        ],
        "summary": "Get a reminder invitation",
        "description": "An invitation to take a reminder that a person of the project shared with the key's person.\n\nIt holds the card, the time and who shared it; the reminder's text is read once the invitation is accepted. An invitation whose card or time no longer allows it is not found.",
        "x-werk-group": "read",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "invitationId",
            "in": "path",
            "required": true,
            "description": "The invitation's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The invitation.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "invitation": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The invitation's id."
                        },
                        "itemId": {
                          "type": "string",
                          "format": "uuid",
                          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                          "description": "The card the shared reminder is on."
                        },
                        "version": {
                          "type": "integer",
                          "exclusiveMinimum": 0,
                          "maximum": 9007199254740991,
                          "description": "The invitation's version; the answer sends it as expectedVersion."
                        },
                        "fireAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                          "description": "The time the reminder is set for."
                        },
                        "setterTimeZone": {
                          "type": "string",
                          "description": "The time zone the reminder's time was set in."
                        },
                        "owner": {
                          "type": "object",
                          "properties": {
                            "userId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The person's id."
                            },
                            "displayName": {
                              "type": "string",
                              "description": "The person's name as the project shows it."
                            },
                            "initials": {
                              "type": "string",
                              "description": "The person's initials, for an avatar with no photo."
                            },
                            "isViewer": {
                              "type": "boolean",
                              "description": "True when the person is the key's own person."
                            },
                            "photo": {
                              "type": "object",
                              "properties": {
                                "personId": {
                                  "type": "string",
                                  "format": "uuid",
                                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                                  "description": "The person whose photo it is."
                                },
                                "version": {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991,
                                  "description": "The photo's version, which changes with the photo; its read takes it to fetch the current one."
                                }
                              },
                              "required": [
                                "personId",
                                "version"
                              ],
                              "additionalProperties": false,
                              "description": "The person's photo, when they have one."
                            }
                          },
                          "required": [
                            "userId",
                            "displayName",
                            "initials",
                            "isViewer"
                          ],
                          "additionalProperties": false,
                          "description": "The person who shared the reminder."
                        }
                      },
                      "required": [
                        "id",
                        "itemId",
                        "version",
                        "fireAt",
                        "setterTimeZone",
                        "owner"
                      ],
                      "additionalProperties": false,
                      "description": "The invitation."
                    }
                  },
                  "required": [
                    "invitation"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "invitation": {
                    "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                    "itemId": "1a7d3f92-6b4e-4c15-8e2a-9f0c5b7d3e81",
                    "version": 1,
                    "fireAt": "2026-11-24T13:00:00.000Z",
                    "setterTimeZone": "America/New_York",
                    "owner": {
                      "userId": "8a2e6c14-3f5d-4b9a-a7e2-61c0d9f4b3e8",
                      "displayName": "Tom Okafor",
                      "initials": "TO",
                      "isViewer": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "personal_reminder_invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/reminder-invitations/{invitationId}/respond": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/reminder-invitations/:invitationId/respond",
        "tags": [
          "reminders"
        ],
        "summary": "Answer a reminder invitation",
        "description": "Accepts or ignores a reminder someone shared with the key's person.\n\nAccepted, the reminder goes off for them too; its owner is not told either way. A second answer is refused, and so is an accept when they already keep five reminders of their own on that card.",
        "x-werk-group": "change",
        "x-werk-area": "reminders",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "invitationId",
            "in": "path",
            "required": true,
            "description": "The invitation's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientRequestId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused."
                  },
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The invitation's version as last read."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "accept",
                      "ignore"
                    ],
                    "description": "accept adds the shared reminder to the key's person's reminders; ignore declines it."
                  }
                },
                "required": [
                  "clientRequestId",
                  "expectedVersion",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a10",
                "expectedVersion": 1,
                "action": "accept"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What the request did.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "enum": [
                        "applied",
                        "unchanged"
                      ],
                      "description": "applied when the change was made, unchanged when it already held."
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The id of the thing changed."
                    },
                    "version": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "Its version after the request."
                    }
                  },
                  "required": [
                    "kind",
                    "id",
                    "version"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "kind": "applied",
                  "id": "e1c6a4f8-0b3d-4e92-8f7a-5c2d9b1e6a30",
                  "version": 2
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_message",
              "personal_reminder_limit"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "personal_reminder_recipient_not_allowed"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "personal_reminder_invitation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "request_conflict",
              "request_erased",
              "personal_reminder_invitation_expired",
              "personal_reminder_stale"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/documents": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/documents",
        "tags": [
          "files"
        ],
        "summary": "List a card's documents",
        "description": "The documents on a card, each with what Werk read in it.\n\nAt most the first 100; hasMore says when there are more.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          }
        ],
        "responses": {
          "200": {
            "description": "The card's documents.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "documents": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The document's id."
                          },
                          "itemId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The card the document is on."
                          },
                          "filename": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "The document's name."
                          },
                          "mimeType": {
                            "type": "string",
                            "enum": [
                              "application/pdf",
                              "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                              "text/csv",
                              "text/plain",
                              "text/markdown"
                            ],
                            "description": "The document's media type."
                          },
                          "revision": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The document's revision, which grows each time its file is replaced."
                          },
                          "state": {
                            "type": "string",
                            "enum": [
                              "not_read",
                              "awaiting_confirmation",
                              "reading",
                              "failed",
                              "ready"
                            ],
                            "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                          },
                          "version": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                          },
                          "totalSources": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "How many parts the document has, or null while not known."
                          },
                          "readSources": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "How many parts Werk read."
                          },
                          "truncated": {
                            "type": "boolean",
                            "description": "True when Werk read only the document's first parts."
                          },
                          "summary": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 2000
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Werk's summary of the document, or null."
                          },
                          "fields": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "issuer": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "value": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 512,
                                            "description": "The issuer as read."
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "documentId": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The document's id."
                                              },
                                              "revision": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The revision it was read in."
                                              },
                                              "page": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                              },
                                              "sha256": {
                                                "type": "string",
                                                "pattern": "^[a-f0-9]{64}$",
                                                "description": "The SHA-256 of the file it was read from."
                                              },
                                              "location": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "pdf_page",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The PDF page."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "page"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "section",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "section": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The section, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "section"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "paragraph",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "paragraph": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The paragraph, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "paragraph"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "sheet_rows",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "sheet": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The sheet's name."
                                                      },
                                                      "firstRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first row."
                                                      },
                                                      "lastRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last row."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "sheet",
                                                      "firstRow",
                                                      "lastRow"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "lines",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "firstLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first line."
                                                      },
                                                      "lastLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last line."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "firstLine",
                                                      "lastLine"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ],
                                                "description": "Where in the file the part is."
                                              }
                                            },
                                            "required": [
                                              "documentId",
                                              "revision",
                                              "page",
                                              "sha256",
                                              "location"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The part of the document it was read from."
                                          }
                                        },
                                        "required": [
                                          "value",
                                          "source"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The issuer Werk read in the document, or null when it found none."
                                  },
                                  "number": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "value": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 128,
                                            "description": "The document's number as read."
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "documentId": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The document's id."
                                              },
                                              "revision": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The revision it was read in."
                                              },
                                              "page": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                              },
                                              "sha256": {
                                                "type": "string",
                                                "pattern": "^[a-f0-9]{64}$",
                                                "description": "The SHA-256 of the file it was read from."
                                              },
                                              "location": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "pdf_page",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The PDF page."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "page"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "section",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "section": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The section, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "section"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "paragraph",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "paragraph": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The paragraph, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "paragraph"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "sheet_rows",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "sheet": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The sheet's name."
                                                      },
                                                      "firstRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first row."
                                                      },
                                                      "lastRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last row."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "sheet",
                                                      "firstRow",
                                                      "lastRow"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "lines",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "firstLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first line."
                                                      },
                                                      "lastLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last line."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "firstLine",
                                                      "lastLine"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ],
                                                "description": "Where in the file the part is."
                                              }
                                            },
                                            "required": [
                                              "documentId",
                                              "revision",
                                              "page",
                                              "sha256",
                                              "location"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The part of the document it was read from."
                                          }
                                        },
                                        "required": [
                                          "value",
                                          "source"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The document's number Werk read in the document, or null when it found none."
                                  },
                                  "date": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "value": {
                                            "type": "string",
                                            "format": "date",
                                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                            "description": "The date as read, as YYYY-MM-DD."
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "documentId": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The document's id."
                                              },
                                              "revision": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The revision it was read in."
                                              },
                                              "page": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                              },
                                              "sha256": {
                                                "type": "string",
                                                "pattern": "^[a-f0-9]{64}$",
                                                "description": "The SHA-256 of the file it was read from."
                                              },
                                              "location": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "pdf_page",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The PDF page."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "page"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "section",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "section": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The section, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "section"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "paragraph",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "paragraph": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The paragraph, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "paragraph"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "sheet_rows",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "sheet": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The sheet's name."
                                                      },
                                                      "firstRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first row."
                                                      },
                                                      "lastRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last row."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "sheet",
                                                      "firstRow",
                                                      "lastRow"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "lines",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "firstLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first line."
                                                      },
                                                      "lastLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last line."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "firstLine",
                                                      "lastLine"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ],
                                                "description": "Where in the file the part is."
                                              }
                                            },
                                            "required": [
                                              "documentId",
                                              "revision",
                                              "page",
                                              "sha256",
                                              "location"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The part of the document it was read from."
                                          }
                                        },
                                        "required": [
                                          "value",
                                          "source"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The date Werk read in the document, or null when it found none."
                                  },
                                  "total": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "value": {
                                            "type": "string",
                                            "maxLength": 128,
                                            "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                            "description": "The total as read, a decimal number with a point."
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "documentId": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The document's id."
                                              },
                                              "revision": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The revision it was read in."
                                              },
                                              "page": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                              },
                                              "sha256": {
                                                "type": "string",
                                                "pattern": "^[a-f0-9]{64}$",
                                                "description": "The SHA-256 of the file it was read from."
                                              },
                                              "location": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "pdf_page",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The PDF page."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "page"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "section",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "section": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The section, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "section"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "paragraph",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "paragraph": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The paragraph, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "paragraph"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "sheet_rows",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "sheet": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The sheet's name."
                                                      },
                                                      "firstRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first row."
                                                      },
                                                      "lastRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last row."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "sheet",
                                                      "firstRow",
                                                      "lastRow"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "lines",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "firstLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first line."
                                                      },
                                                      "lastLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last line."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "firstLine",
                                                      "lastLine"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ],
                                                "description": "Where in the file the part is."
                                              }
                                            },
                                            "required": [
                                              "documentId",
                                              "revision",
                                              "page",
                                              "sha256",
                                              "location"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The part of the document it was read from."
                                          }
                                        },
                                        "required": [
                                          "value",
                                          "source"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The total Werk read in the document, or null when it found none."
                                  },
                                  "currency": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "value": {
                                            "type": "string",
                                            "pattern": "^[A-Z]{3}$",
                                            "description": "The currency as read, its ISO 4217 code."
                                          },
                                          "source": {
                                            "type": "object",
                                            "properties": {
                                              "documentId": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The document's id."
                                              },
                                              "revision": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The revision it was read in."
                                              },
                                              "page": {
                                                "type": "integer",
                                                "exclusiveMinimum": 0,
                                                "maximum": 9007199254740991,
                                                "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                              },
                                              "sha256": {
                                                "type": "string",
                                                "pattern": "^[a-f0-9]{64}$",
                                                "description": "The SHA-256 of the file it was read from."
                                              },
                                              "location": {
                                                "oneOf": [
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "pdf_page",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "page": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The PDF page."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "page"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "section",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "section": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The section, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "section"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "paragraph",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "paragraph": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The paragraph, counted from 1."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "paragraph"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "sheet_rows",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "sheet": {
                                                        "type": "string",
                                                        "minLength": 1,
                                                        "description": "The sheet's name."
                                                      },
                                                      "firstRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first row."
                                                      },
                                                      "lastRow": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last row."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "sheet",
                                                      "firstRow",
                                                      "lastRow"
                                                    ],
                                                    "additionalProperties": false
                                                  },
                                                  {
                                                    "type": "object",
                                                    "properties": {
                                                      "kind": {
                                                        "type": "string",
                                                        "const": "lines",
                                                        "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                      },
                                                      "firstLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's first line."
                                                      },
                                                      "lastLine": {
                                                        "type": "integer",
                                                        "exclusiveMinimum": 0,
                                                        "maximum": 9007199254740991,
                                                        "description": "The part's last line."
                                                      }
                                                    },
                                                    "required": [
                                                      "kind",
                                                      "firstLine",
                                                      "lastLine"
                                                    ],
                                                    "additionalProperties": false
                                                  }
                                                ],
                                                "description": "Where in the file the part is."
                                              }
                                            },
                                            "required": [
                                              "documentId",
                                              "revision",
                                              "page",
                                              "sha256",
                                              "location"
                                            ],
                                            "additionalProperties": false,
                                            "description": "The part of the document it was read from."
                                          }
                                        },
                                        "required": [
                                          "value",
                                          "source"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "The currency Werk read in the document, or null when it found none."
                                  }
                                },
                                "required": [
                                  "issuer",
                                  "number",
                                  "date",
                                  "total",
                                  "currency"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                          },
                          "failureCode": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "parse_failed",
                                  "encrypted",
                                  "unsupported_format",
                                  "transcription_failed",
                                  "summary_failed",
                                  "invalid_output",
                                  "access_lost",
                                  "limit_exceeded",
                                  "provider_unavailable"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Why reading failed, or null."
                          },
                          "units": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                          },
                          "pages": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                          },
                          "sheets": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "A workbook's sheets with data; null for other files or when not known."
                          },
                          "removable": {
                            "type": "boolean",
                            "description": "True when the key's person may take this document off the card now."
                          }
                        },
                        "required": [
                          "id",
                          "itemId",
                          "filename",
                          "mimeType",
                          "revision",
                          "state",
                          "version",
                          "totalSources",
                          "readSources",
                          "truncated",
                          "summary",
                          "fields",
                          "failureCode",
                          "units",
                          "pages",
                          "sheets",
                          "removable"
                        ],
                        "additionalProperties": false
                      },
                      "description": "The card's first 100 documents."
                    },
                    "hasMore": {
                      "type": "boolean",
                      "description": "True when the card has more documents than these."
                    }
                  },
                  "required": [
                    "documents",
                    "hasMore"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "documents": [
                    {
                      "id": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                      "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                      "filename": "countertop-quote.pdf",
                      "mimeType": "application/pdf",
                      "revision": 1,
                      "state": "ready",
                      "version": 3,
                      "totalSources": 2,
                      "readSources": 2,
                      "truncated": false,
                      "summary": "Stonecraft Supply's quote for a quartz countertop, cut and installed, with delivery in two weeks.",
                      "fields": {
                        "issuer": {
                          "value": "Stonecraft Supply",
                          "source": {
                            "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                            "revision": 1,
                            "page": 1,
                            "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                            "location": {
                              "kind": "pdf_page",
                              "page": 1
                            }
                          }
                        },
                        "number": {
                          "value": "Q-20931",
                          "source": {
                            "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                            "revision": 1,
                            "page": 1,
                            "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                            "location": {
                              "kind": "pdf_page",
                              "page": 1
                            }
                          }
                        },
                        "date": {
                          "value": "2026-11-17",
                          "source": {
                            "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                            "revision": 1,
                            "page": 1,
                            "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                            "location": {
                              "kind": "pdf_page",
                              "page": 1
                            }
                          }
                        },
                        "total": {
                          "value": "2480.00",
                          "source": {
                            "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                            "revision": 1,
                            "page": 2,
                            "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                            "location": {
                              "kind": "pdf_page",
                              "page": 2
                            }
                          }
                        },
                        "currency": {
                          "value": "USD",
                          "source": {
                            "documentId": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                            "revision": 1,
                            "page": 2,
                            "sha256": "9f2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a1c3e5b7d9f1a3c5e7b9d0f",
                            "location": {
                              "kind": "pdf_page",
                              "page": 2
                            }
                          }
                        }
                      },
                      "failureCode": null,
                      "units": 1,
                      "pages": 2,
                      "sheets": null,
                      "removable": true
                    }
                  ],
                  "hasMore": false
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/documents/{documentId}/read-now": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/documents/:documentId/read-now",
        "tags": [
          "files"
        ],
        "summary": "Read a document now",
        "description": "Asks Werk to read a document it did not read by itself.\n\nThe answer says whether reading started, why it was not, or that it waits for a yes to its cost. A refusal of the read is an answer of kind refused, with its own code.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "The document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expectedVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The document's version as last read; when it changed since, the request is refused."
                  },
                  "revision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 2147483647,
                    "description": "The document's revision as last read."
                  }
                },
                "required": [
                  "expectedVersion",
                  "revision"
                ],
                "additionalProperties": false
              },
              "example": {
                "expectedVersion": 2,
                "revision": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What came of the request.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "reading",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The document's id."
                            },
                            "itemId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card the document is on."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name."
                            },
                            "mimeType": {
                              "type": "string",
                              "enum": [
                                "application/pdf",
                                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                "text/csv",
                                "text/plain",
                                "text/markdown"
                              ],
                              "description": "The document's media type."
                            },
                            "revision": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's revision, which grows each time its file is replaced."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_read",
                                "awaiting_confirmation",
                                "reading",
                                "failed",
                                "ready"
                              ],
                              "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                            },
                            "totalSources": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "How many parts the document has, or null while not known."
                            },
                            "readSources": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many parts Werk read."
                            },
                            "truncated": {
                              "type": "boolean",
                              "description": "True when Werk read only the document's first parts."
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Werk's summary of the document, or null."
                            },
                            "fields": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "issuer": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512,
                                              "description": "The issuer as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The issuer Werk read in the document, or null when it found none."
                                    },
                                    "number": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 128,
                                              "description": "The document's number as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The document's number Werk read in the document, or null when it found none."
                                    },
                                    "date": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The date as read, as YYYY-MM-DD."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The date Werk read in the document, or null when it found none."
                                    },
                                    "total": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "maxLength": 128,
                                              "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                              "description": "The total as read, a decimal number with a point."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The total Werk read in the document, or null when it found none."
                                    },
                                    "currency": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "pattern": "^[A-Z]{3}$",
                                              "description": "The currency as read, its ISO 4217 code."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The currency Werk read in the document, or null when it found none."
                                    }
                                  },
                                  "required": [
                                    "issuer",
                                    "number",
                                    "date",
                                    "total",
                                    "currency"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                            },
                            "failureCode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "parse_failed",
                                    "encrypted",
                                    "unsupported_format",
                                    "transcription_failed",
                                    "summary_failed",
                                    "invalid_output",
                                    "access_lost",
                                    "limit_exceeded",
                                    "provider_unavailable"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why reading failed, or null."
                            },
                            "units": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                            },
                            "sheets": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A workbook's sheets with data; null for other files or when not known."
                            },
                            "removable": {
                              "type": "boolean",
                              "description": "True when the key's person may take this document off the card now."
                            }
                          },
                          "required": [
                            "id",
                            "itemId",
                            "filename",
                            "mimeType",
                            "revision",
                            "state",
                            "version",
                            "totalSources",
                            "readSources",
                            "truncated",
                            "summary",
                            "fields",
                            "failureCode",
                            "units",
                            "pages",
                            "sheets",
                            "removable"
                          ],
                          "additionalProperties": false,
                          "description": "The document after the request."
                        },
                        "replay": {
                          "type": "boolean",
                          "description": "True when this answers a request already taken."
                        }
                      },
                      "required": [
                        "kind",
                        "document",
                        "replay"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "not_read",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The document's id."
                            },
                            "itemId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card the document is on."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name."
                            },
                            "mimeType": {
                              "type": "string",
                              "enum": [
                                "application/pdf",
                                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                "text/csv",
                                "text/plain",
                                "text/markdown"
                              ],
                              "description": "The document's media type."
                            },
                            "revision": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's revision, which grows each time its file is replaced."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_read",
                                "awaiting_confirmation",
                                "reading",
                                "failed",
                                "ready"
                              ],
                              "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                            },
                            "totalSources": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "How many parts the document has, or null while not known."
                            },
                            "readSources": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many parts Werk read."
                            },
                            "truncated": {
                              "type": "boolean",
                              "description": "True when Werk read only the document's first parts."
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Werk's summary of the document, or null."
                            },
                            "fields": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "issuer": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512,
                                              "description": "The issuer as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The issuer Werk read in the document, or null when it found none."
                                    },
                                    "number": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 128,
                                              "description": "The document's number as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The document's number Werk read in the document, or null when it found none."
                                    },
                                    "date": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The date as read, as YYYY-MM-DD."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The date Werk read in the document, or null when it found none."
                                    },
                                    "total": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "maxLength": 128,
                                              "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                              "description": "The total as read, a decimal number with a point."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The total Werk read in the document, or null when it found none."
                                    },
                                    "currency": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "pattern": "^[A-Z]{3}$",
                                              "description": "The currency as read, its ISO 4217 code."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The currency Werk read in the document, or null when it found none."
                                    }
                                  },
                                  "required": [
                                    "issuer",
                                    "number",
                                    "date",
                                    "total",
                                    "currency"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                            },
                            "failureCode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "parse_failed",
                                    "encrypted",
                                    "unsupported_format",
                                    "transcription_failed",
                                    "summary_failed",
                                    "invalid_output",
                                    "access_lost",
                                    "limit_exceeded",
                                    "provider_unavailable"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why reading failed, or null."
                            },
                            "units": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                            },
                            "sheets": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A workbook's sheets with data; null for other files or when not known."
                            },
                            "removable": {
                              "type": "boolean",
                              "description": "True when the key's person may take this document off the card now."
                            }
                          },
                          "required": [
                            "id",
                            "itemId",
                            "filename",
                            "mimeType",
                            "revision",
                            "state",
                            "version",
                            "totalSources",
                            "readSources",
                            "truncated",
                            "summary",
                            "fields",
                            "failureCode",
                            "units",
                            "pages",
                            "sheets",
                            "removable"
                          ],
                          "additionalProperties": false,
                          "description": "The document after the request."
                        }
                      },
                      "required": [
                        "kind",
                        "document"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "awaiting_confirmation",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The document's id."
                            },
                            "itemId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card the document is on."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name."
                            },
                            "mimeType": {
                              "type": "string",
                              "enum": [
                                "application/pdf",
                                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                "text/csv",
                                "text/plain",
                                "text/markdown"
                              ],
                              "description": "The document's media type."
                            },
                            "revision": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's revision, which grows each time its file is replaced."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_read",
                                "awaiting_confirmation",
                                "reading",
                                "failed",
                                "ready"
                              ],
                              "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                            },
                            "totalSources": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "How many parts the document has, or null while not known."
                            },
                            "readSources": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many parts Werk read."
                            },
                            "truncated": {
                              "type": "boolean",
                              "description": "True when Werk read only the document's first parts."
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Werk's summary of the document, or null."
                            },
                            "fields": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "issuer": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512,
                                              "description": "The issuer as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The issuer Werk read in the document, or null when it found none."
                                    },
                                    "number": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 128,
                                              "description": "The document's number as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The document's number Werk read in the document, or null when it found none."
                                    },
                                    "date": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The date as read, as YYYY-MM-DD."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The date Werk read in the document, or null when it found none."
                                    },
                                    "total": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "maxLength": 128,
                                              "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                              "description": "The total as read, a decimal number with a point."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The total Werk read in the document, or null when it found none."
                                    },
                                    "currency": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "pattern": "^[A-Z]{3}$",
                                              "description": "The currency as read, its ISO 4217 code."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The currency Werk read in the document, or null when it found none."
                                    }
                                  },
                                  "required": [
                                    "issuer",
                                    "number",
                                    "date",
                                    "total",
                                    "currency"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                            },
                            "failureCode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "parse_failed",
                                    "encrypted",
                                    "unsupported_format",
                                    "transcription_failed",
                                    "summary_failed",
                                    "invalid_output",
                                    "access_lost",
                                    "limit_exceeded",
                                    "provider_unavailable"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why reading failed, or null."
                            },
                            "units": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                            },
                            "sheets": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A workbook's sheets with data; null for other files or when not known."
                            },
                            "removable": {
                              "type": "boolean",
                              "description": "True when the key's person may take this document off the card now."
                            }
                          },
                          "required": [
                            "id",
                            "itemId",
                            "filename",
                            "mimeType",
                            "revision",
                            "state",
                            "version",
                            "totalSources",
                            "readSources",
                            "truncated",
                            "summary",
                            "fields",
                            "failureCode",
                            "units",
                            "pages",
                            "sheets",
                            "removable"
                          ],
                          "additionalProperties": false,
                          "description": "The document after the request."
                        },
                        "consent": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The question's id, sent as consentId."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The question's version, sent as expectedConsentVersion."
                            },
                            "units": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "What the reading counts on the plan, in messages."
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the question lapses."
                            },
                            "message": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 72,
                              "description": "The question as Werk asks it, in the reader's language."
                            }
                          },
                          "required": [
                            "id",
                            "version",
                            "units",
                            "expiresAt",
                            "message"
                          ],
                          "additionalProperties": false,
                          "description": "The question about the reading's cost, answered with the consent route."
                        }
                      },
                      "required": [
                        "kind",
                        "document",
                        "consent"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "refused",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "code": {
                          "type": "string",
                          "enum": [
                            "plan_limit",
                            "share_used",
                            "plan_unavailable",
                            "collaborator_unfunded",
                            "source_unavailable",
                            "stale_document",
                            "inspection_required",
                            "stale_consent",
                            "consent_expired",
                            "consent_settled",
                            "not_approver",
                            "source_conflict"
                          ],
                          "description": "Why the request could not be taken."
                        }
                      },
                      "required": [
                        "kind",
                        "code"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "kind": "reading",
                  "document": {
                    "id": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                    "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "filename": "countertop-quote.pdf",
                    "mimeType": "application/pdf",
                    "revision": 1,
                    "state": "reading",
                    "version": 3,
                    "totalSources": 2,
                    "readSources": 0,
                    "truncated": false,
                    "summary": null,
                    "fields": null,
                    "failureCode": null,
                    "units": 1,
                    "pages": 2,
                    "sheets": null,
                    "removable": true
                  },
                  "replay": false
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_media"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/documents/{documentId}/consent": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/cards/:cardId/documents/:documentId/consent",
        "tags": [
          "files"
        ],
        "summary": "Answer a reading's cost",
        "description": "Says yes or no to the cost Werk asked before reading a long document.\n\nYes starts the reading at its cost on the plan; no leaves the document unread. A question that changed or ended answers kind refused.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "The document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "consentId": {
                    "type": "string",
                    "format": "uuid",
                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                    "description": "The id of the question about the reading's cost."
                  },
                  "expectedConsentVersion": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "The question's version as last read."
                  },
                  "accept": {
                    "type": "boolean",
                    "description": "True reads the document at its cost, false leaves it unread."
                  }
                },
                "required": [
                  "consentId",
                  "expectedConsentVersion",
                  "accept"
                ],
                "additionalProperties": false
              },
              "example": {
                "consentId": "d2a6c0e4-9b3f-4d5b-87a9-2b8c0f4d6a08",
                "expectedConsentVersion": 1,
                "accept": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "What came of the answer.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "reading",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The document's id."
                            },
                            "itemId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card the document is on."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name."
                            },
                            "mimeType": {
                              "type": "string",
                              "enum": [
                                "application/pdf",
                                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                "text/csv",
                                "text/plain",
                                "text/markdown"
                              ],
                              "description": "The document's media type."
                            },
                            "revision": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's revision, which grows each time its file is replaced."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_read",
                                "awaiting_confirmation",
                                "reading",
                                "failed",
                                "ready"
                              ],
                              "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                            },
                            "totalSources": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "How many parts the document has, or null while not known."
                            },
                            "readSources": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many parts Werk read."
                            },
                            "truncated": {
                              "type": "boolean",
                              "description": "True when Werk read only the document's first parts."
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Werk's summary of the document, or null."
                            },
                            "fields": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "issuer": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512,
                                              "description": "The issuer as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The issuer Werk read in the document, or null when it found none."
                                    },
                                    "number": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 128,
                                              "description": "The document's number as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The document's number Werk read in the document, or null when it found none."
                                    },
                                    "date": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The date as read, as YYYY-MM-DD."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The date Werk read in the document, or null when it found none."
                                    },
                                    "total": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "maxLength": 128,
                                              "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                              "description": "The total as read, a decimal number with a point."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The total Werk read in the document, or null when it found none."
                                    },
                                    "currency": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "pattern": "^[A-Z]{3}$",
                                              "description": "The currency as read, its ISO 4217 code."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The currency Werk read in the document, or null when it found none."
                                    }
                                  },
                                  "required": [
                                    "issuer",
                                    "number",
                                    "date",
                                    "total",
                                    "currency"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                            },
                            "failureCode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "parse_failed",
                                    "encrypted",
                                    "unsupported_format",
                                    "transcription_failed",
                                    "summary_failed",
                                    "invalid_output",
                                    "access_lost",
                                    "limit_exceeded",
                                    "provider_unavailable"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why reading failed, or null."
                            },
                            "units": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                            },
                            "sheets": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A workbook's sheets with data; null for other files or when not known."
                            },
                            "removable": {
                              "type": "boolean",
                              "description": "True when the key's person may take this document off the card now."
                            }
                          },
                          "required": [
                            "id",
                            "itemId",
                            "filename",
                            "mimeType",
                            "revision",
                            "state",
                            "version",
                            "totalSources",
                            "readSources",
                            "truncated",
                            "summary",
                            "fields",
                            "failureCode",
                            "units",
                            "pages",
                            "sheets",
                            "removable"
                          ],
                          "additionalProperties": false,
                          "description": "The document after the request."
                        },
                        "replay": {
                          "type": "boolean",
                          "description": "True when this answers a request already taken."
                        }
                      },
                      "required": [
                        "kind",
                        "document",
                        "replay"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "not_read",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The document's id."
                            },
                            "itemId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card the document is on."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name."
                            },
                            "mimeType": {
                              "type": "string",
                              "enum": [
                                "application/pdf",
                                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                "text/csv",
                                "text/plain",
                                "text/markdown"
                              ],
                              "description": "The document's media type."
                            },
                            "revision": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's revision, which grows each time its file is replaced."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_read",
                                "awaiting_confirmation",
                                "reading",
                                "failed",
                                "ready"
                              ],
                              "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                            },
                            "totalSources": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "How many parts the document has, or null while not known."
                            },
                            "readSources": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many parts Werk read."
                            },
                            "truncated": {
                              "type": "boolean",
                              "description": "True when Werk read only the document's first parts."
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Werk's summary of the document, or null."
                            },
                            "fields": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "issuer": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512,
                                              "description": "The issuer as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The issuer Werk read in the document, or null when it found none."
                                    },
                                    "number": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 128,
                                              "description": "The document's number as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The document's number Werk read in the document, or null when it found none."
                                    },
                                    "date": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The date as read, as YYYY-MM-DD."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The date Werk read in the document, or null when it found none."
                                    },
                                    "total": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "maxLength": 128,
                                              "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                              "description": "The total as read, a decimal number with a point."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The total Werk read in the document, or null when it found none."
                                    },
                                    "currency": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "pattern": "^[A-Z]{3}$",
                                              "description": "The currency as read, its ISO 4217 code."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The currency Werk read in the document, or null when it found none."
                                    }
                                  },
                                  "required": [
                                    "issuer",
                                    "number",
                                    "date",
                                    "total",
                                    "currency"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                            },
                            "failureCode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "parse_failed",
                                    "encrypted",
                                    "unsupported_format",
                                    "transcription_failed",
                                    "summary_failed",
                                    "invalid_output",
                                    "access_lost",
                                    "limit_exceeded",
                                    "provider_unavailable"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why reading failed, or null."
                            },
                            "units": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                            },
                            "sheets": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A workbook's sheets with data; null for other files or when not known."
                            },
                            "removable": {
                              "type": "boolean",
                              "description": "True when the key's person may take this document off the card now."
                            }
                          },
                          "required": [
                            "id",
                            "itemId",
                            "filename",
                            "mimeType",
                            "revision",
                            "state",
                            "version",
                            "totalSources",
                            "readSources",
                            "truncated",
                            "summary",
                            "fields",
                            "failureCode",
                            "units",
                            "pages",
                            "sheets",
                            "removable"
                          ],
                          "additionalProperties": false,
                          "description": "The document after the request."
                        }
                      },
                      "required": [
                        "kind",
                        "document"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "awaiting_confirmation",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The document's id."
                            },
                            "itemId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The card the document is on."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name."
                            },
                            "mimeType": {
                              "type": "string",
                              "enum": [
                                "application/pdf",
                                "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
                                "text/csv",
                                "text/plain",
                                "text/markdown"
                              ],
                              "description": "The document's media type."
                            },
                            "revision": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's revision, which grows each time its file is replaced."
                            },
                            "state": {
                              "type": "string",
                              "enum": [
                                "not_read",
                                "awaiting_confirmation",
                                "reading",
                                "failed",
                                "ready"
                              ],
                              "description": "not_read while it is not being read, awaiting_confirmation while Werk waits for a yes to its cost, reading, failed, or ready."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The document's version, which grows with every change to it; a read request sends it as expectedVersion."
                            },
                            "totalSources": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "How many parts the document has, or null while not known."
                            },
                            "readSources": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many parts Werk read."
                            },
                            "truncated": {
                              "type": "boolean",
                              "description": "True when Werk read only the document's first parts."
                            },
                            "summary": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 2000
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Werk's summary of the document, or null."
                            },
                            "fields": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "issuer": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 512,
                                              "description": "The issuer as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The issuer Werk read in the document, or null when it found none."
                                    },
                                    "number": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "minLength": 1,
                                              "maxLength": 128,
                                              "description": "The document's number as read."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The document's number Werk read in the document, or null when it found none."
                                    },
                                    "date": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "format": "date",
                                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
                                              "description": "The date as read, as YYYY-MM-DD."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The date Werk read in the document, or null when it found none."
                                    },
                                    "total": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "maxLength": 128,
                                              "pattern": "^-?(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
                                              "description": "The total as read, a decimal number with a point."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The total Werk read in the document, or null when it found none."
                                    },
                                    "currency": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "value": {
                                              "type": "string",
                                              "pattern": "^[A-Z]{3}$",
                                              "description": "The currency as read, its ISO 4217 code."
                                            },
                                            "source": {
                                              "type": "object",
                                              "properties": {
                                                "documentId": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The document's id."
                                                },
                                                "revision": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The revision it was read in."
                                                },
                                                "page": {
                                                  "type": "integer",
                                                  "exclusiveMinimum": 0,
                                                  "maximum": 9007199254740991,
                                                  "description": "The part, counted from 1 in Werk's own count; only a PDF page's location names a page of the file."
                                                },
                                                "sha256": {
                                                  "type": "string",
                                                  "pattern": "^[a-f0-9]{64}$",
                                                  "description": "The SHA-256 of the file it was read from."
                                                },
                                                "location": {
                                                  "oneOf": [
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "pdf_page",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "page": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The PDF page."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "page"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "section",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "section": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The section, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "section"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "paragraph",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "paragraph": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The paragraph, counted from 1."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "paragraph"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "sheet_rows",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "sheet": {
                                                          "type": "string",
                                                          "minLength": 1,
                                                          "description": "The sheet's name."
                                                        },
                                                        "firstRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first row."
                                                        },
                                                        "lastRow": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last row."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "sheet",
                                                        "firstRow",
                                                        "lastRow"
                                                      ],
                                                      "additionalProperties": false
                                                    },
                                                    {
                                                      "type": "object",
                                                      "properties": {
                                                        "kind": {
                                                          "type": "string",
                                                          "const": "lines",
                                                          "description": "Where in the file the part is: a PDF page, a section, a paragraph, a sheet's rows or a text's lines."
                                                        },
                                                        "firstLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's first line."
                                                        },
                                                        "lastLine": {
                                                          "type": "integer",
                                                          "exclusiveMinimum": 0,
                                                          "maximum": 9007199254740991,
                                                          "description": "The part's last line."
                                                        }
                                                      },
                                                      "required": [
                                                        "kind",
                                                        "firstLine",
                                                        "lastLine"
                                                      ],
                                                      "additionalProperties": false
                                                    }
                                                  ],
                                                  "description": "Where in the file the part is."
                                                }
                                              },
                                              "required": [
                                                "documentId",
                                                "revision",
                                                "page",
                                                "sha256",
                                                "location"
                                              ],
                                              "additionalProperties": false,
                                              "description": "The part of the document it was read from."
                                            }
                                          },
                                          "required": [
                                            "value",
                                            "source"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "description": "The currency Werk read in the document, or null when it found none."
                                    }
                                  },
                                  "required": [
                                    "issuer",
                                    "number",
                                    "date",
                                    "total",
                                    "currency"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "The issuer, number, date, total and currency Werk read in the document, or null."
                            },
                            "failureCode": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "parse_failed",
                                    "encrypted",
                                    "unsupported_format",
                                    "transcription_failed",
                                    "summary_failed",
                                    "invalid_output",
                                    "access_lost",
                                    "limit_exceeded",
                                    "provider_unavailable"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Why reading failed, or null."
                            },
                            "units": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "What reading the document counts on the plan, in messages, or null before Werk inspected it."
                            },
                            "pages": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A PDF's pages, or other text in pages of 3,000 characters; null when not known."
                            },
                            "sheets": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "exclusiveMinimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "A workbook's sheets with data; null for other files or when not known."
                            },
                            "removable": {
                              "type": "boolean",
                              "description": "True when the key's person may take this document off the card now."
                            }
                          },
                          "required": [
                            "id",
                            "itemId",
                            "filename",
                            "mimeType",
                            "revision",
                            "state",
                            "version",
                            "totalSources",
                            "readSources",
                            "truncated",
                            "summary",
                            "fields",
                            "failureCode",
                            "units",
                            "pages",
                            "sheets",
                            "removable"
                          ],
                          "additionalProperties": false,
                          "description": "The document after the request."
                        },
                        "consent": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The question's id, sent as consentId."
                            },
                            "version": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "The question's version, sent as expectedConsentVersion."
                            },
                            "units": {
                              "type": "integer",
                              "exclusiveMinimum": 0,
                              "maximum": 9007199254740991,
                              "description": "What the reading counts on the plan, in messages."
                            },
                            "expiresAt": {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
                              "description": "When the question lapses."
                            },
                            "message": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 72,
                              "description": "The question as Werk asks it, in the reader's language."
                            }
                          },
                          "required": [
                            "id",
                            "version",
                            "units",
                            "expiresAt",
                            "message"
                          ],
                          "additionalProperties": false,
                          "description": "The question about the reading's cost, answered with the consent route."
                        }
                      },
                      "required": [
                        "kind",
                        "document",
                        "consent"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "const": "refused",
                          "description": "reading once Werk reads it, not_read when it will not, awaiting_confirmation while it waits for a yes to its cost, refused when the request could not be taken."
                        },
                        "code": {
                          "type": "string",
                          "enum": [
                            "plan_limit",
                            "share_used",
                            "plan_unavailable",
                            "collaborator_unfunded",
                            "source_unavailable",
                            "stale_document",
                            "inspection_required",
                            "stale_consent",
                            "consent_expired",
                            "consent_settled",
                            "not_approver",
                            "source_conflict"
                          ],
                          "description": "Why the request could not be taken."
                        }
                      },
                      "required": [
                        "kind",
                        "code"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "example": {
                  "kind": "reading",
                  "document": {
                    "id": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59",
                    "itemId": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48",
                    "filename": "countertop-quote.pdf",
                    "mimeType": "application/pdf",
                    "revision": 1,
                    "state": "reading",
                    "version": 3,
                    "totalSources": 2,
                    "readSources": 0,
                    "truncated": false,
                    "summary": null,
                    "fields": null,
                    "failureCode": null,
                    "units": 1,
                    "pages": 2,
                    "sheets": null,
                    "removable": true
                  },
                  "replay": false
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_media"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/cards/{cardId}/documents/{documentId}/original": {
      "get": {
        "operationId": "GET /api/v1/projects/:projectId/cards/:cardId/documents/:documentId/original",
        "tags": [
          "files"
        ],
        "summary": "Download a document",
        "description": "The document's original file, as an attachment.\n\nWith If-None-Match holding its current ETag, the answer is 304 with no body.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "cardId",
            "in": "path",
            "required": true,
            "description": "The card's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "3c9e5b17-8d2f-4a64-b1e3-7f5a0c9d2b48"
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "The document's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "d7e1b5c3-9a4f-4e26-b8d0-2f6a4c8e1d59"
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "The ETag of a copy already held. When it is current, the answer is 304.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The original file.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/pdf"
                }
              },
              "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
                }
              },
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/csv"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/plain"
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/markdown"
                }
              }
            }
          },
          "304": {
            "description": "The copy held is current."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "item_not_found",
              "asset_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/assets": {
      "post": {
        "operationId": "POST /api/v1/assets",
        "tags": [
          "files"
        ],
        "summary": "Upload a file directly",
        "description": "Uploads one photo, document or voice recording as its bytes, for a card, a project, the key's person's photo or a report to use.\n\nIts kind follows Content-Type: a JPEG is a photo, a document's type or Werk-Filename a document, an audio type a recording. An upload not used within 24 hours is let go.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "query",
            "required": false,
            "description": "The project the upload is for.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "const": ""
                },
                {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                }
              ]
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "purpose",
            "in": "query",
            "required": false,
            "description": "profile_photo for the key's person's photo, account_feedback for a report's recording; it takes no project.",
            "schema": {
              "type": "string",
              "enum": [
                "account_feedback",
                "profile_photo"
              ]
            }
          },
          {
            "name": "Werk-Locale",
            "in": "header",
            "required": false,
            "description": "The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "An id the caller makes for this request; sent again with it and the same bytes, it changes nothing twice.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4e03"
          },
          {
            "name": "Werk-Filename",
            "in": "header",
            "required": false,
            "description": "A document's name, percent-encoded.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "image/jpeg": {
              "schema": {
                "type": "string",
                "contentMediaType": "image/jpeg"
              }
            },
            "audio/mp4": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/mp4"
              }
            },
            "audio/x-m4a": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/x-m4a"
              }
            },
            "audio/webm": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/webm"
              }
            },
            "audio/ogg": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/ogg"
              }
            },
            "application/pdf": {
              "schema": {
                "type": "string",
                "contentMediaType": "application/pdf"
              }
            },
            "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
              "schema": {
                "type": "string",
                "contentMediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
              }
            },
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
              "schema": {
                "type": "string",
                "contentMediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
              }
            },
            "text/csv": {
              "schema": {
                "type": "string",
                "contentMediaType": "text/csv"
              }
            },
            "text/plain": {
              "schema": {
                "type": "string",
                "contentMediaType": "text/plain"
              }
            },
            "text/markdown": {
              "schema": {
                "type": "string",
                "contentMediaType": "text/markdown"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The upload.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid",
                      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                      "description": "The file's id."
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "image",
                        "audio",
                        "document"
                      ],
                      "description": "What the file is: a photo, a voice recording or a document."
                    },
                    "filename": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255,
                      "description": "The document's name; only a document has one."
                    },
                    "format": {
                      "type": "string",
                      "enum": [
                        "pdf",
                        "docx",
                        "xlsx",
                        "csv",
                        "txt",
                        "md"
                      ],
                      "description": "The document's format; only a document has one."
                    },
                    "mimeType": {
                      "type": "string",
                      "minLength": 1,
                      "description": "The file's media type."
                    },
                    "sizeBytes": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The file's size in bytes."
                    },
                    "width": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The photo's width in pixels; absent on photos stored before sizes were kept."
                    },
                    "height": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991,
                      "description": "The photo's height in pixels; absent on photos stored before sizes were kept."
                    },
                    "durationSeconds": {
                      "type": "number",
                      "exclusiveMinimum": 0,
                      "maximum": 300,
                      "description": "The recording's length in seconds; only a voice recording has one."
                    },
                    "available": {
                      "type": "boolean",
                      "description": "False once the file's bytes were released and it can no longer be read."
                    }
                  },
                  "required": [
                    "id",
                    "kind",
                    "mimeType",
                    "sizeBytes"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "id": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                  "kind": "image",
                  "mimeType": "image/jpeg",
                  "sizeBytes": 482113,
                  "width": 1600,
                  "height": 1200
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_idempotency_key",
              "conversation_required",
              "invalid_media",
              "photo_side_too_large",
              "unsupported_media_type",
              "document_unsupported_format",
              "document_password_protected",
              "document_unreadable"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "not_for_client"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "idempotency_conflict"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large",
              "document_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/projects/{projectId}/upload-grants": {
      "post": {
        "operationId": "POST /api/v1/projects/:projectId/upload-grants",
        "tags": [
          "files"
        ],
        "summary": "Get upload addresses",
        "description": "Makes one upload address per file to add, valid an hour, each with the most bytes it takes.\n\nEach address carries its own grant, so the bytes are sent there with no key. The upload's id then goes in a card's attachments.",
        "x-werk-group": "create",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization",
          "Content-Type"
        ],
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "description": "The project's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "image",
                              "description": "image for a photo, document for a document."
                            }
                          },
                          "required": [
                            "kind"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "document",
                              "description": "image for a photo, document for a document."
                            },
                            "filename": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 255,
                              "description": "The document's name as Werk will show it."
                            }
                          },
                          "required": [
                            "kind",
                            "filename"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "description": "One entry per file to upload, in order."
                  }
                },
                "required": [
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "files": [
                  {
                    "kind": "image"
                  },
                  {
                    "kind": "document",
                    "filename": "countertop-quote.pdf"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The upload addresses.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "grants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "assetId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The upload's id, which the card's request then names."
                          },
                          "path": {
                            "type": "string",
                            "description": "The address under the API's base to send the file's bytes to; it carries its own grant, so it needs no key."
                          },
                          "maxBytes": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "The most bytes the file may have."
                          },
                          "maxSide": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "For a photo, the most pixels its longer side may have."
                          }
                        },
                        "required": [
                          "assetId",
                          "path",
                          "maxBytes"
                        ],
                        "additionalProperties": false
                      },
                      "description": "One upload address per file, in the order asked."
                    }
                  },
                  "required": [
                    "grants"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "grants": [
                    {
                      "assetId": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82",
                      "path": "/assets/f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82/upload/AQJ4c2VhbGVkLWdyYW50LWZvci10aGUtZmlsZQ",
                      "maxBytes": 2097152,
                      "maxSide": 2048
                    },
                    {
                      "assetId": "a2d8f4b6-1c9e-4a37-8b5f-0e3c7a9d2f14",
                      "path": "/assets/a2d8f4b6-1c9e-4a37-8b5f-0e3c7a9d2f14/upload/AQJ4c2VhbGVkLWdyYW50LWZvci10aGUtZmlsZQ",
                      "maxBytes": 10485760
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_attachment",
              "invalid_media"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "403": {
            "description": "The key's person may not do this.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "photos_unavailable"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/assets/{assetId}/upload/{grant}": {
      "put": {
        "operationId": "PUT /api/v1/assets/:assetId/upload/:grant",
        "tags": [
          "files"
        ],
        "summary": "Upload a file",
        "description": "Sends one file's bytes to the upload address its grant made.\n\nIt needs no key: the grant names who uploads and what. Sent again with the same bytes it changes nothing; other bytes are refused.",
        "x-werk-group": "change",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Content-Type"
        ],
        "security": [],
        "parameters": [
          {
            "name": "assetId",
            "in": "path",
            "required": true,
            "description": "The upload's id, as the address names it.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82"
          },
          {
            "name": "grant",
            "in": "path",
            "required": true,
            "description": "The grant, as the address names it.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "AQJ4c2VhbGVkLWdyYW50LWZvci10aGUtZmlsZQ"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "image/jpeg": {
              "schema": {
                "type": "string",
                "contentMediaType": "image/jpeg"
              }
            },
            "audio/mp4": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/mp4"
              }
            },
            "audio/x-m4a": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/x-m4a"
              }
            },
            "audio/webm": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/webm"
              }
            },
            "audio/ogg": {
              "schema": {
                "type": "string",
                "contentMediaType": "audio/ogg"
              }
            },
            "application/pdf": {
              "schema": {
                "type": "string",
                "contentMediaType": "application/pdf"
              }
            },
            "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
              "schema": {
                "type": "string",
                "contentMediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
              }
            },
            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
              "schema": {
                "type": "string",
                "contentMediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
              }
            },
            "text/csv": {
              "schema": {
                "type": "string",
                "contentMediaType": "text/csv"
              }
            },
            "text/plain": {
              "schema": {
                "type": "string",
                "contentMediaType": "text/plain"
              }
            },
            "text/markdown": {
              "schema": {
                "type": "string",
                "contentMediaType": "text/markdown"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The file is stored."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query",
              "invalid_media",
              "photo_side_too_large",
              "unsupported_media_type",
              "document_unsupported_format",
              "document_password_protected",
              "document_unreadable"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "conversation_not_found",
              "upload_grant_invalid"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed",
              "project_deleted",
              "project_archived",
              "upload_grant_expired",
              "idempotency_conflict"
            ]
          },
          "413": {
            "description": "The body is larger than this route takes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "payload_too_large",
              "document_too_large"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    },
    "/assets/{assetId}": {
      "get": {
        "operationId": "GET /api/v1/assets/:assetId",
        "tags": [
          "files"
        ],
        "summary": "Get an upload",
        "description": "The bytes of a file the key's person uploaded, or one shown to them on a card or sent to them, in a project.\n\nWith If-None-Match holding its current ETag, the answer is 304 with no body.",
        "x-werk-group": "read",
        "x-werk-area": "cards",
        "x-werk-portal-send-headers": [
          "Authorization"
        ],
        "parameters": [
          {
            "name": "assetId",
            "in": "path",
            "required": true,
            "description": "The upload's id.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            "example": "f3a9c1e7-5b2d-4c68-a4e0-9d7b3f1c5e82"
          },
          {
            "name": "project",
            "in": "query",
            "required": false,
            "description": "The project the file is in.",
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "const": ""
                },
                {
                  "type": "string",
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
                }
              ]
            },
            "example": "2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73"
          },
          {
            "name": "If-None-Match",
            "in": "header",
            "required": false,
            "description": "The ETag of a copy already held. When it is current, the answer is 304.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The file's bytes.",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "image/jpeg"
                }
              },
              "audio/mp4": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "audio/mp4"
                }
              },
              "audio/x-m4a": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "audio/x-m4a"
                }
              },
              "audio/webm": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "audio/webm"
                }
              },
              "audio/ogg": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "audio/ogg"
                }
              },
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/pdf"
                }
              },
              "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
                }
              },
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/csv"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/plain"
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "contentMediaType": "text/markdown"
                }
              }
            }
          },
          "304": {
            "description": "The copy held is current."
          },
          "400": {
            "description": "The request is not valid; the code names what is wrong.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "invalid_query"
            ]
          },
          "401": {
            "description": "The key is not valid, or it has expired.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_revoked",
              "session_expired"
            ]
          },
          "404": {
            "description": "What the request names is not found, or is not the key's person's to see.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "asset_not_found",
              "conversation_not_found"
            ]
          },
          "409": {
            "description": "The request conflicts with the current state; the code says how.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "session_changed"
            ]
          },
          "429": {
            "description": "Too many requests; send again after the seconds Retry-After gives.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "rate_limited"
            ]
          },
          "500": {
            "description": "The server could not complete the request, and it is not known whether a write it holds was made.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "x-werk-codes": [
              "server_error"
            ]
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "key": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "plan_limit",
                  "share_used",
                  "plan_unavailable",
                  "collaborator_unfunded",
                  "invalid_input_facts",
                  "unsupported_input_tariff",
                  "input_source_conflict",
                  "source_unavailable",
                  "plan_funding_version_conflict",
                  "plan_funding_foreign_participant",
                  "plan_funding_own_plan_participant",
                  "plan_funding_capacity",
                  "plan_funding_unavailable",
                  "invalid_plan_activation",
                  "invalid_plan_transaction",
                  "plan_activation_refused",
                  "client_update_required",
                  "invalid_registration_context",
                  "sign_in_start_expired",
                  "sign_in_unavailable",
                  "personal_project_restricted",
                  "personal_project_unavailable",
                  "follow_invitation_unavailable",
                  "follow_invitation_not_found",
                  "connect_request_not_found",
                  "follow_invitation_expired",
                  "follow_invitation_stale",
                  "follow_invitation_request_conflict",
                  "follow_invitation_actor_not_allowed",
                  "follow_invitation_source_expired",
                  "reserved_project_name",
                  "name_reserved",
                  "connection_name_fixed",
                  "invalid_connection_name",
                  "connection_not_found",
                  "api_key_not_found",
                  "due_notice_owner_admin_required",
                  "account_code_expired",
                  "account_code_locked",
                  "account_code_used",
                  "account_owns_projects",
                  "actor_not_allowed",
                  "appearance_conflict",
                  "asset_already_submitted",
                  "asset_not_found",
                  "batch_already_open",
                  "batch_closed",
                  "batch_expired",
                  "batch_not_found",
                  "card_archived",
                  "checklist_item_not_found",
                  "code_key_changed",
                  "conversation_not_found",
                  "conversation_required",
                  "cursor_expired",
                  "device_proof_invalid",
                  "device_required",
                  "due_past",
                  "duplicate_project_step",
                  "empty_text",
                  "google_calendar_start_expired",
                  "idempotency_conflict",
                  "invalid_account_code",
                  "invalid_account_request",
                  "invalid_client_platform",
                  "invalid_appearance",
                  "invalid_attachment",
                  "invalid_batch",
                  "invalid_capture_order",
                  "invalid_card_query",
                  "invalid_card_size",
                  "invalid_checklist_request",
                  "invalid_choice",
                  "invalid_client_message_id",
                  "invalid_cursor",
                  "invalid_device",
                  "invalid_push_subscription",
                  "invalid_feedback",
                  "invalid_feedback_detail",
                  "invalid_follow",
                  "invalid_idempotency_key",
                  "invalid_limit",
                  "invalid_media",
                  "invalid_message",
                  "invalid_pairing_code",
                  "invalid_people_request",
                  "invalid_project_color",
                  "invalid_project_name",
                  "invalid_project_order",
                  "invalid_project_request",
                  "invalid_project_step_label",
                  "invalid_project_steps",
                  "invalid_query",
                  "invalid_read",
                  "invalid_setting",
                  "invalid_read_anchor",
                  "invalid_reply_context",
                  "invalid_translation_request",
                  "invitation_not_found",
                  "item_not_found",
                  "legacy_submission",
                  "member_not_found",
                  "message_in_custody",
                  "not_a_member",
                  "not_found",
                  "not_for_client",
                  "not_permitted",
                  "notice_not_found",
                  "order_mismatch",
                  "origin_refused",
                  "payload_too_large",
                  "person_not_found",
                  "project_archived",
                  "project_config_changed",
                  "project_deleted",
                  "project_deletion_expired",
                  "project_first_step_not_open",
                  "project_last_step_not_finished",
                  "project_not_archived",
                  "project_not_deleting",
                  "project_not_found",
                  "project_not_permitted",
                  "project_order_mismatch",
                  "project_photo_not_found",
                  "project_profile_changed",
                  "rate_limited",
                  "recipient_not_found",
                  "request_conflict",
                  "personal_reminder_actor_not_allowed",
                  "personal_reminder_invalid_time",
                  "personal_reminder_invitation_expired",
                  "personal_reminder_invitation_not_found",
                  "personal_reminder_limit",
                  "personal_reminder_not_found",
                  "personal_reminder_not_owner",
                  "personal_reminder_recipient_not_allowed",
                  "personal_reminder_request_conflict",
                  "personal_reminder_source_expired",
                  "personal_reminder_stale",
                  "personal_reminder_text_too_long",
                  "revision_conflict",
                  "item_version_conflict",
                  "list_exists",
                  "locale_unserved",
                  "source_expired",
                  "request_erased",
                  "setting_version_conflict",
                  "session_changed",
                  "session_expired",
                  "beta_access_required",
                  "beta_code_invalid",
                  "voice_unavailable",
                  "photos_unavailable",
                  "account_suspended",
                  "session_revoked",
                  "template_not_found",
                  "template_not_hideable",
                  "text_too_long",
                  "too_few_project_steps",
                  "too_many_items",
                  "too_many_project_steps",
                  "unauthorized",
                  "unsupported_media_type",
                  "photo_side_too_large",
                  "document_too_large",
                  "document_unsupported_format",
                  "document_password_protected",
                  "document_unreadable",
                  "update_not_found",
                  "upload_grant_invalid",
                  "upload_grant_expired",
                  "download_grant_invalid",
                  "download_grant_expired",
                  "server_error"
                ],
                "description": "The refusal's code, one per outcome, as the Errors page lists them."
              },
              "retryable": {
                "type": "boolean",
                "description": "True when the same request may succeed if sent again later."
              },
              "description": {
                "type": "string",
                "minLength": 1,
                "description": "What the code means, in English."
              },
              "details": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "planActivationReason": {
                        "type": "string",
                        "description": "Why a plan could not be made active."
                      }
                    },
                    "required": [
                      "planActivationReason"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "projects": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "conversationId": {
                              "type": "string",
                              "description": "The id Werk's apps use for the person's view of the project."
                            },
                            "projectId": {
                              "type": "string",
                              "format": "uuid",
                              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                              "description": "The project's id."
                            },
                            "name": {
                              "type": "string",
                              "description": "The project's name."
                            },
                            "memberCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "How many people the project has."
                            }
                          },
                          "required": [
                            "conversationId",
                            "name",
                            "memberCount"
                          ],
                          "additionalProperties": false
                        },
                        "description": "The projects that hold the request back."
                      }
                    },
                    "required": [
                      "projects"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "offerPersonalReminder": {
                        "type": "object",
                        "properties": {
                          "itemId": {
                            "type": "string",
                            "format": "uuid",
                            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                            "description": "The card."
                          }
                        },
                        "required": [
                          "itemId"
                        ],
                        "additionalProperties": false,
                        "description": "Present when the change is not the person's to make and a reminder of their own on the card can stand in for it."
                      }
                    },
                    "required": [
                      "offerPersonalReminder"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "field": {
                        "type": "string",
                        "minLength": 1,
                        "description": "The input that was refused."
                      },
                      "limit": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "The bound that input passed, in the unit the code's description names."
                      }
                    },
                    "additionalProperties": false
                  }
                ],
                "description": "More about the refusal, on the codes that carry it."
              },
              "message": {
                "type": "string",
                "description": "A line about the refusal in the reader's language, for a person to read; present only on the codes that carry one."
              },
              "unavailableAssetId": {
                "type": "string",
                "description": "The uploaded file that could not be used."
              },
              "retryAfterSeconds": {
                "type": "number",
                "minimum": 0,
                "description": "How many seconds to wait before sending again, as the Retry-After header says."
              }
            },
            "required": [
              "code",
              "retryable"
            ],
            "additionalProperties": false,
            "description": "What was refused, and why."
          }
        },
        "required": [
          "error"
        ],
        "additionalProperties": false
      }
    }
  },
  "x-werk-errors": [
    {
      "code": "invalid_client_message_id",
      "status": 400,
      "retryable": false,
      "description": "The client message id the upload names is not a uuid."
    },
    {
      "code": "plan_limit",
      "status": 409,
      "retryable": false,
      "description": "The plan that pays for this use has too little left this month for this request."
    },
    {
      "code": "share_used",
      "status": 409,
      "retryable": false,
      "description": "The signed-in person's share of the project owner's plan has too little left this month for this request."
    },
    {
      "code": "plan_unavailable",
      "status": 409,
      "retryable": false,
      "description": "No plan pays for this use by the signed-in person."
    },
    {
      "code": "collaborator_unfunded",
      "status": 409,
      "retryable": false,
      "description": "The project owner's plan does not fund the signed-in person, a collaborator in the project."
    },
    {
      "code": "invalid_input_facts",
      "status": 409,
      "retryable": false,
      "description": "The stored facts that a sent file's cost is counted from are missing or do not agree."
    },
    {
      "code": "unsupported_input_tariff",
      "status": 409,
      "retryable": false,
      "description": "A sent file is of a kind whose cost no tariff counts."
    },
    {
      "code": "input_source_conflict",
      "status": 409,
      "retryable": false,
      "description": "A file the message carries no longer matches what was stored for it when it was sent."
    },
    {
      "code": "source_unavailable",
      "status": 409,
      "retryable": false,
      "description": "A file the request needs, or a record stored for it, is no longer available."
    },
    {
      "code": "plan_funding_version_conflict",
      "status": 409,
      "retryable": false,
      "description": "The plan's funding changed after the version the request names."
    },
    {
      "code": "plan_funding_foreign_participant",
      "status": 403,
      "retryable": false,
      "description": "A person the request names for the plan's funding is not one this plan may fund."
    },
    {
      "code": "plan_funding_own_plan_participant",
      "status": 409,
      "retryable": false,
      "description": "A person the request names for the plan's funding pays with a plan of their own."
    },
    {
      "code": "plan_funding_capacity",
      "status": 409,
      "retryable": false,
      "description": "The plan funds fewer people than the request names."
    },
    {
      "code": "plan_funding_unavailable",
      "status": 409,
      "retryable": false,
      "description": "The signed-in person has no plan whose funding can be set."
    },
    {
      "code": "invalid_plan_activation",
      "status": 400,
      "retryable": false,
      "description": "The plan activation is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_plan_transaction",
      "status": 400,
      "retryable": false,
      "description": "The store transaction the request sends could not be verified for the product it names."
    },
    {
      "code": "plan_activation_refused",
      "status": 409,
      "retryable": false,
      "description": "The verified store transaction does not activate a plan, for the reason the details name."
    },
    {
      "code": "client_update_required",
      "status": 409,
      "retryable": false,
      "description": "The app release that sent the request is older than the server accepts."
    },
    {
      "code": "invalid_registration_context",
      "status": 400,
      "retryable": false,
      "description": "The invitation code or link the sign-up names is not one the new account can join with."
    },
    {
      "code": "personal_project_restricted",
      "status": 403,
      "retryable": false,
      "description": "The request acts on the signed-in person's own My Werk, which only they see, or on a reminder with no card, which lives there, and My Werk does not take this action."
    },
    {
      "code": "personal_project_unavailable",
      "status": 400,
      "retryable": false,
      "description": "The signed-in person's own My Werk is not available to hold a reminder with no card."
    },
    {
      "code": "follow_invitation_unavailable",
      "status": 400,
      "retryable": false,
      "description": "The person invited has left the project, or the card is no longer visible to both people."
    },
    {
      "code": "follow_invitation_not_found",
      "status": 404,
      "retryable": false,
      "description": "The invitation to follow a card that the request names is not one waiting for the signed-in person."
    },
    {
      "code": "connect_request_not_found",
      "status": 404,
      "retryable": false,
      "description": "The handle names no open authorization request: it is unknown, expired, or already approved or denied."
    },
    {
      "code": "follow_invitation_expired",
      "status": 409,
      "retryable": false,
      "description": "The invitation to follow a card has expired."
    },
    {
      "code": "follow_invitation_stale",
      "status": 409,
      "retryable": false,
      "description": "The card changed after the version the invitation to follow it names."
    },
    {
      "code": "follow_invitation_request_conflict",
      "status": 409,
      "retryable": false,
      "description": "The request id was already used for another invitation to follow a card."
    },
    {
      "code": "follow_invitation_actor_not_allowed",
      "status": 403,
      "retryable": false,
      "description": "The signed-in person may not invite anyone to follow a card here."
    },
    {
      "code": "follow_invitation_source_expired",
      "status": 409,
      "retryable": false,
      "description": "The message the invitation to follow a card was made from is too old to make it now."
    },
    {
      "code": "reserved_project_name",
      "status": 409,
      "retryable": false,
      "description": "The project name is one Werk keeps for the person's own My Werk."
    },
    {
      "code": "name_reserved",
      "status": 400,
      "retryable": false,
      "description": "The name is a verified app's name, which no key or connection a person names takes."
    },
    {
      "code": "connection_name_fixed",
      "status": 409,
      "retryable": false,
      "description": "This connection's name is its verified app's and is not changed."
    },
    {
      "code": "invalid_connection_name",
      "status": 400,
      "retryable": false,
      "description": "The name is missing, not text, cleared on a key, longer in characters than it holds, or empty once cleaned of control and direction characters and trimmed; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "connection_not_found",
      "status": 404,
      "retryable": false,
      "description": "The connection id names none of the signed-in person's live connections."
    },
    {
      "code": "api_key_not_found",
      "status": 404,
      "retryable": false,
      "description": "The key id names none of the signed-in person's live API keys."
    },
    {
      "code": "due_notice_owner_admin_required",
      "status": 403,
      "retryable": false,
      "description": "Only the project's owner or an admin sets a card's due notice."
    },
    {
      "code": "account_code_expired",
      "status": 401,
      "retryable": false,
      "description": "The sign-in code has expired."
    },
    {
      "code": "account_code_locked",
      "status": 401,
      "retryable": false,
      "description": "The sign-in code was tried wrongly too many times and is locked."
    },
    {
      "code": "account_code_used",
      "status": 401,
      "retryable": false,
      "description": "The sign-in code was already used."
    },
    {
      "code": "account_owns_projects",
      "status": 409,
      "retryable": false,
      "description": "The account owns projects with other people in them, which the details list, so it cannot be deleted."
    },
    {
      "code": "actor_not_allowed",
      "status": 403,
      "retryable": false,
      "description": "The signed-in person may not make this change to the card."
    },
    {
      "code": "appearance_conflict",
      "status": 409,
      "retryable": false,
      "description": "The project's look for the signed-in person changed after the revision the request names."
    },
    {
      "code": "asset_already_submitted",
      "status": 409,
      "retryable": false,
      "description": "The uploaded file already went with another request; an upload goes with one request only."
    },
    {
      "code": "asset_not_found",
      "status": 404,
      "retryable": false,
      "description": "The file the request names is not one the signed-in person can reach where the request names it, or is no longer available."
    },
    {
      "code": "batch_already_open",
      "status": 409,
      "retryable": false,
      "description": "A batch of messages sent from this device is already open for the project."
    },
    {
      "code": "batch_closed",
      "status": 409,
      "retryable": false,
      "description": "The batch of messages the request names is already closed."
    },
    {
      "code": "batch_expired",
      "status": 409,
      "retryable": false,
      "description": "The batch of messages the request names has expired."
    },
    {
      "code": "batch_not_found",
      "status": 404,
      "retryable": false,
      "description": "The batch of messages the request names is not one of this device."
    },
    {
      "code": "card_archived",
      "status": 409,
      "retryable": false,
      "description": "The card is archived, so it does not take this change."
    },
    {
      "code": "checklist_item_not_found",
      "status": 404,
      "retryable": false,
      "description": "The list entry the request names is not on the card's list."
    },
    {
      "code": "code_key_changed",
      "status": 409,
      "retryable": false,
      "description": "The invitation code or link was made with a key the server no longer holds."
    },
    {
      "code": "conversation_not_found",
      "status": 404,
      "retryable": false,
      "description": "The project the request names, or its chat, is not one the signed-in person is in."
    },
    {
      "code": "conversation_required",
      "status": 400,
      "retryable": false,
      "description": "The request names no project, and the session has no project of its own to use."
    },
    {
      "code": "cursor_expired",
      "status": 409,
      "retryable": false,
      "description": "The page cursor no longer fits the list as it stands or the arguments it was read with."
    },
    {
      "code": "google_calendar_start_expired",
      "status": 409,
      "retryable": false,
      "description": "The Google Calendar connection this request completes has expired."
    },
    {
      "code": "device_proof_invalid",
      "status": 403,
      "retryable": false,
      "description": "The device the request names, or its proof, does not match the device registered for this session."
    },
    {
      "code": "device_required",
      "status": 409,
      "retryable": false,
      "description": "The session has no registered device, which this request needs."
    },
    {
      "code": "due_past",
      "status": 400,
      "retryable": false,
      "description": "The due date is in the past."
    },
    {
      "code": "duplicate_project_step",
      "status": 400,
      "retryable": false,
      "description": "Two of the steps sent are the same step."
    },
    {
      "code": "empty_text",
      "status": 400,
      "retryable": false,
      "description": "The text is empty once trimmed."
    },
    {
      "code": "idempotency_conflict",
      "status": 409,
      "retryable": false,
      "description": "The request's key, or the upload address it was sent to, was already used with other content."
    },
    {
      "code": "invalid_account_code",
      "status": 401,
      "retryable": false,
      "description": "The sign-in code is not the one sent to the account."
    },
    {
      "code": "invalid_client_platform",
      "status": 400,
      "retryable": false,
      "description": "The client platform the request names is not one Werk serves."
    },
    {
      "code": "invalid_account_request",
      "status": 400,
      "retryable": false,
      "description": "The account request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_appearance",
      "status": 400,
      "retryable": false,
      "description": "The appearance is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_attachment",
      "status": 400,
      "retryable": false,
      "description": "A file the request names, or the way it names it, is not one the request takes there; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_batch",
      "status": 400,
      "retryable": false,
      "description": "The batch of messages is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_capture_order",
      "status": 400,
      "retryable": false,
      "description": "Another message of the batch already holds the place the request gives this one."
    },
    {
      "code": "invalid_card_size",
      "status": 400,
      "retryable": false,
      "description": "The card size is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_card_query",
      "status": 400,
      "retryable": false,
      "description": "The request about cards or their files is not in the form its route takes, or names a day of a filter while the signed-in person's profile has no time zone; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_checklist_request",
      "status": 400,
      "retryable": false,
      "description": "The list request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_choice",
      "status": 400,
      "retryable": false,
      "description": "The option the request picks is not one the question still offers."
    },
    {
      "code": "invalid_cursor",
      "status": 400,
      "retryable": false,
      "description": "The page cursor is not one this list gave."
    },
    {
      "code": "invalid_device",
      "status": 400,
      "retryable": false,
      "description": "The device is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_push_subscription",
      "status": 400,
      "retryable": false,
      "description": "The web push subscription is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_feedback",
      "status": 400,
      "retryable": false,
      "description": "The message feedback is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_feedback_detail",
      "status": 400,
      "retryable": false,
      "description": "The feedback detail or the report is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_follow",
      "status": 400,
      "retryable": false,
      "description": "The follow request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_idempotency_key",
      "status": 400,
      "retryable": false,
      "description": "The Idempotency-Key header is not a uuid."
    },
    {
      "code": "invalid_limit",
      "status": 400,
      "retryable": false,
      "description": "The page size, or the number of entries asked, is not one the list takes."
    },
    {
      "code": "invalid_media",
      "status": 400,
      "retryable": false,
      "description": "The file, its name or the request about it is not in a form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_message",
      "status": 400,
      "retryable": false,
      "description": "The message or reminder request is not in the form its route takes, or names a card its reminder is not on; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_pairing_code",
      "status": 401,
      "retryable": false,
      "description": "The pairing code is not a valid code."
    },
    {
      "code": "invalid_people_request",
      "status": 400,
      "retryable": false,
      "description": "The people request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_project_color",
      "status": 400,
      "retryable": false,
      "description": "The project color is not one Werk offers."
    },
    {
      "code": "invalid_project_name",
      "status": 400,
      "retryable": false,
      "description": "The project name is missing, empty once trimmed, or longer in characters than it holds."
    },
    {
      "code": "invalid_project_order",
      "status": 400,
      "retryable": false,
      "description": "The project order is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_project_request",
      "status": 400,
      "retryable": false,
      "description": "The project request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_project_step_label",
      "status": 400,
      "retryable": false,
      "description": "A step's name is missing, empty once trimmed, or longer in characters than it holds."
    },
    {
      "code": "invalid_project_steps",
      "status": 400,
      "retryable": false,
      "description": "The steps sent leave no step of the right kind for the cards of a step they remove."
    },
    {
      "code": "invalid_query",
      "status": 400,
      "retryable": false,
      "description": "The query is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_read",
      "status": 400,
      "retryable": false,
      "description": "The read mark is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_setting",
      "status": 400,
      "retryable": false,
      "description": "The setting, its value or the read of its history is not one the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invalid_read_anchor",
      "status": 400,
      "retryable": false,
      "description": "The message the read mark names is not one of the signed-in person's chat in this project."
    },
    {
      "code": "invalid_reply_context",
      "status": 400,
      "retryable": false,
      "description": "The message the answer replies to is not one Werk sent to the signed-in person."
    },
    {
      "code": "invalid_translation_request",
      "status": 400,
      "retryable": false,
      "description": "The translation request is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number)."
    },
    {
      "code": "invitation_not_found",
      "status": 404,
      "retryable": false,
      "description": "The invitation the request names is not an open one of this project."
    },
    {
      "code": "item_not_found",
      "status": 404,
      "retryable": false,
      "description": "The card the request names, or its list, is not one the signed-in person can see."
    },
    {
      "code": "legacy_submission",
      "status": 409,
      "retryable": false,
      "description": "The message was first sent by an app release whose sends cannot be repeated in a batch."
    },
    {
      "code": "member_not_found",
      "status": 404,
      "retryable": false,
      "description": "The person the request names is not one of Werk's people."
    },
    {
      "code": "message_in_custody",
      "status": 409,
      "retryable": false,
      "description": "The message is already held by another batch of sends."
    },
    {
      "code": "not_a_member",
      "status": 403,
      "retryable": false,
      "description": "The signed-in person is not in the project."
    },
    {
      "code": "not_found",
      "status": 404,
      "retryable": false,
      "description": "The route or record the request names does not exist, or is not one the signed-in person can reach."
    },
    {
      "code": "not_for_client",
      "status": 403,
      "retryable": false,
      "description": "The route, setting or input the request names is open only to Werk's own apps, and the request's session is a connected app's or an API key's."
    },
    {
      "code": "not_permitted",
      "status": 403,
      "retryable": false,
      "description": "The signed-in person's role, or whose the record is, does not allow this request."
    },
    {
      "code": "notice_not_found",
      "status": 404,
      "retryable": false,
      "description": "The notice the request names is not one of the signed-in person's."
    },
    {
      "code": "order_mismatch",
      "status": 400,
      "retryable": false,
      "description": "The order sent does not hold exactly the list's entries."
    },
    {
      "code": "payload_too_large",
      "status": 413,
      "retryable": false,
      "description": "The request body has more bytes than the route takes."
    },
    {
      "code": "person_not_found",
      "status": 404,
      "retryable": false,
      "description": "The person the request is about is not one the signed-in person can reach."
    },
    {
      "code": "project_archived",
      "status": 409,
      "retryable": false,
      "description": "The project is archived, so it does not take this request."
    },
    {
      "code": "project_config_changed",
      "status": 409,
      "retryable": false,
      "description": "The project's setup, or the projects the request covers, changed after the version the request names or while it ran."
    },
    {
      "code": "project_deleted",
      "status": 409,
      "retryable": false,
      "description": "The project is being deleted."
    },
    {
      "code": "project_deletion_expired",
      "status": 409,
      "retryable": false,
      "description": "The time to restore the deleted project has passed."
    },
    {
      "code": "project_first_step_not_open",
      "status": 400,
      "retryable": false,
      "description": "The steps sent put a step that is not of an open kind first."
    },
    {
      "code": "project_last_step_not_finished",
      "status": 400,
      "retryable": false,
      "description": "The steps sent put a step that is not of a finished kind last."
    },
    {
      "code": "project_not_archived",
      "status": 409,
      "retryable": false,
      "description": "The project is not archived."
    },
    {
      "code": "project_not_deleting",
      "status": 409,
      "retryable": false,
      "description": "The project is not being deleted."
    },
    {
      "code": "project_not_found",
      "status": 404,
      "retryable": false,
      "description": "The project the request names is not one the signed-in person can reach."
    },
    {
      "code": "project_not_permitted",
      "status": 403,
      "retryable": false,
      "description": "The signed-in person's role in the project does not allow this request on the project."
    },
    {
      "code": "project_order_mismatch",
      "status": 409,
      "retryable": false,
      "description": "The order sent does not hold exactly the signed-in person's projects."
    },
    {
      "code": "project_photo_not_found",
      "status": 404,
      "retryable": false,
      "description": "The project has no photo, or none at the version the request names."
    },
    {
      "code": "project_profile_changed",
      "status": 409,
      "retryable": false,
      "description": "The project's setup changed while the cards were read."
    },
    {
      "code": "rate_limited",
      "status": 429,
      "retryable": true,
      "description": "More requests of this kind were sent than Werk takes within the time it counts them over."
    },
    {
      "code": "recipient_not_found",
      "status": 404,
      "retryable": false,
      "description": "The person a message is for, or the message, is no longer one Werk delivers to."
    },
    {
      "code": "request_conflict",
      "status": 409,
      "retryable": false,
      "description": "The request id was already used with another request, or the change it asks could not be made to the record it names."
    },
    {
      "code": "personal_reminder_actor_not_allowed",
      "status": 403,
      "retryable": false,
      "description": "The signed-in person may not set or change a reminder here."
    },
    {
      "code": "personal_reminder_invalid_time",
      "status": 400,
      "retryable": false,
      "description": "The reminder's time is not one a reminder can be set to."
    },
    {
      "code": "personal_reminder_invitation_expired",
      "status": 409,
      "retryable": false,
      "description": "The invitation to the shared reminder has expired, or its reminder has already rung."
    },
    {
      "code": "personal_reminder_invitation_not_found",
      "status": 404,
      "retryable": false,
      "description": "The invitation to a shared reminder that the request names is not one waiting for the signed-in person."
    },
    {
      "code": "personal_reminder_limit",
      "status": 400,
      "retryable": false,
      "description": "The signed-in person already has as many reminders on this card as one person can have on a card."
    },
    {
      "code": "personal_reminder_not_found",
      "status": 404,
      "retryable": false,
      "description": "The reminder the request names is not one the signed-in person can reach."
    },
    {
      "code": "personal_reminder_not_owner",
      "status": 403,
      "retryable": false,
      "description": "The reminder belongs to another person."
    },
    {
      "code": "personal_reminder_recipient_not_allowed",
      "status": 403,
      "retryable": false,
      "description": "The person the reminder is shared with is not one who can see its card."
    },
    {
      "code": "personal_reminder_request_conflict",
      "status": 409,
      "retryable": false,
      "description": "The request id was already used with another reminder request."
    },
    {
      "code": "personal_reminder_source_expired",
      "status": 409,
      "retryable": false,
      "description": "The message the reminder was asked in is too old to set it now."
    },
    {
      "code": "personal_reminder_stale",
      "status": 409,
      "retryable": false,
      "description": "The reminder or its card changed after the version the request names."
    },
    {
      "code": "personal_reminder_text_too_long",
      "status": 400,
      "retryable": false,
      "description": "The reminder's text is longer than a reminder holds."
    },
    {
      "code": "revision_conflict",
      "status": 409,
      "retryable": false,
      "description": "The card's list changed after the revision the request names."
    },
    {
      "code": "item_version_conflict",
      "status": 409,
      "retryable": false,
      "description": "The card changed after the version the request names."
    },
    {
      "code": "list_exists",
      "status": 400,
      "retryable": false,
      "description": "The card already has a list."
    },
    {
      "code": "locale_unserved",
      "status": 400,
      "retryable": false,
      "description": "The language the request names is not one Werk serves."
    },
    {
      "code": "source_expired",
      "status": 409,
      "retryable": false,
      "description": "The message the list change was asked in is too old to make it now."
    },
    {
      "code": "request_erased",
      "status": 409,
      "retryable": false,
      "description": "The request id belongs to a request whose record was erased."
    },
    {
      "code": "setting_version_conflict",
      "status": 409,
      "retryable": false,
      "description": "The setting changed after the version the request names."
    },
    {
      "code": "session_changed",
      "status": 409,
      "retryable": true,
      "description": "The session changed while the request was in flight."
    },
    {
      "code": "origin_refused",
      "status": 403,
      "retryable": false,
      "description": "The request came from a web origin the server does not accept."
    },
    {
      "code": "session_expired",
      "status": 401,
      "retryable": false,
      "description": "The session has expired."
    },
    {
      "code": "beta_access_required",
      "status": 403,
      "retryable": false,
      "description": "The account is not on the list of people the beta admits."
    },
    {
      "code": "beta_code_invalid",
      "status": 403,
      "retryable": false,
      "description": "The beta access code is not a valid one."
    },
    {
      "code": "voice_unavailable",
      "status": 403,
      "retryable": false,
      "description": "Voice notes are not open to the signed-in person."
    },
    {
      "code": "photos_unavailable",
      "status": 403,
      "retryable": false,
      "description": "Photos are not open to the signed-in person."
    },
    {
      "code": "account_suspended",
      "status": 403,
      "retryable": false,
      "description": "The account is suspended."
    },
    {
      "code": "session_revoked",
      "status": 401,
      "retryable": false,
      "description": "The request carries no session the server holds, or its session has ended."
    },
    {
      "code": "template_not_found",
      "status": 404,
      "retryable": false,
      "description": "The step template the request names is not one the signed-in person has."
    },
    {
      "code": "template_not_hideable",
      "status": 400,
      "retryable": false,
      "description": "The step template the request names is Werk's simple one, which is never hidden."
    },
    {
      "code": "text_too_long",
      "status": 400,
      "retryable": false,
      "description": "The text has more characters than its field holds."
    },
    {
      "code": "too_few_project_steps",
      "status": 400,
      "retryable": false,
      "description": "The project would have fewer steps than a project needs."
    },
    {
      "code": "too_many_items",
      "status": 400,
      "retryable": false,
      "description": "The card's list would hold more entries than a list holds."
    },
    {
      "code": "too_many_project_steps",
      "status": 400,
      "retryable": false,
      "description": "The project would hold more steps than a project holds."
    },
    {
      "code": "unauthorized",
      "status": 401,
      "retryable": false,
      "description": "The account the request signs in to is deleted or being deleted."
    },
    {
      "code": "unsupported_media_type",
      "status": 400,
      "retryable": false,
      "description": "The file's type is not one the route takes."
    },
    {
      "code": "photo_side_too_large",
      "status": 400,
      "retryable": false,
      "description": "The photo's longer side has more pixels than this request takes."
    },
    {
      "code": "document_too_large",
      "status": 413,
      "retryable": false,
      "description": "The document has more bytes than Werk reads."
    },
    {
      "code": "document_unsupported_format",
      "status": 400,
      "retryable": false,
      "description": "The document's format is not one Werk reads."
    },
    {
      "code": "document_password_protected",
      "status": 400,
      "retryable": false,
      "description": "The document is protected by a password."
    },
    {
      "code": "document_unreadable",
      "status": 400,
      "retryable": false,
      "description": "The document could not be read."
    },
    {
      "code": "update_not_found",
      "status": 404,
      "retryable": false,
      "description": "The update the request names is not on the card."
    },
    {
      "code": "upload_grant_invalid",
      "status": 404,
      "retryable": false,
      "description": "This upload address is not one Werk gave, or it was changed."
    },
    {
      "code": "upload_grant_expired",
      "status": 409,
      "retryable": false,
      "description": "This upload address has expired and takes no file."
    },
    {
      "code": "download_grant_invalid",
      "status": 404,
      "retryable": false,
      "description": "This download address is not one Werk gave, or it was changed."
    },
    {
      "code": "download_grant_expired",
      "status": 409,
      "retryable": false,
      "description": "This download address has expired and gives no file."
    },
    {
      "code": "sign_in_start_expired",
      "status": 409,
      "retryable": false,
      "description": "The sign-in start the request names cannot be used by this request."
    },
    {
      "code": "sign_in_unavailable",
      "status": 503,
      "retryable": false,
      "description": "This server has no sign-in with the provider the request names."
    },
    {
      "code": "server_error",
      "status": 500,
      "retryable": true,
      "description": "The server could not complete the request, and it is not known whether a write it holds was made."
    },
    {
      "code": "session_context_changed",
      "status": 401,
      "retryable": false,
      "description": "The account or person the session names changed while the request was in flight."
    }
  ],
  "x-werk-limits": {
    "outsideShare": {
      "requests": {
        "burst": 50,
        "perSecond": 1
      },
      "readsInFlight": 22
    },
    "outsideCeiling": {
      "requests": {
        "burst": 100,
        "perSecond": 2
      },
      "readsInFlight": 44
    },
    "sizes": {
      "cardTitle": 200,
      "cardDescription": 500,
      "listEntries": 100,
      "listEntryText": 200,
      "filesPerRequest": 10,
      "keyName": 128
    }
  },
  "x-werk-scope": {
    "can": [
      "cards",
      "reminders",
      "projects",
      "people",
      "profile",
      "report"
    ],
    "cannot": [
      "chat",
      "undo",
      "plan",
      "account_deletion",
      "screen_look"
    ]
  }
}
