> ## Documentation Index > Fetch the complete documentation index at: https://docs.onosso.app/llms.txt > Use this file to discover all available pages before exploring further. # Put one thing on a day of the week > A one-off item typed in the app: on `date`, at `time` when given and untimed otherwise, for `subjectId`, taken on by `assigneeId` when given. It is stored `confirmed`, with `sourceKind` `app` and the `operationId` as its `sourceRef`. The same command again returns the same item; `operationId` makes a retry safe. ## OpenAPI ````yaml /openapi.json post /v1/week/activities openapi: 3.0.0 info: title: onosso version: 0.0.0 description: >- The household's API: the week, the people and the sessions the web app reads and changes. servers: [] security: [] tags: - name: Week description: The household's week, day by day. - name: People description: The people who make up the household. - name: Pets description: The pets of the house. - name: Invites description: Links that let someone join. - name: Sessions description: Where you are signed in. - name: Tokens description: Your personal API tokens. - name: Address description: Where the household lives. - name: Messages description: What each person receives from the product, and when. - name: Questions description: 'What needs a person: one queue, the same in the app and on WhatsApp.' - name: Shopping description: 'The household''s one list: places, items and marks.' - name: Conversation description: >- Each person's one conversation with the assistant, the same in the app and on WhatsApp. - name: MCP description: The house for an MCP client such as Claude Desktop, with a personal token. paths: /v1/week/activities: post: tags: - Week summary: Put one thing on a day of the week description: >- A one-off item typed in the app: on `date`, at `time` when given and untimed otherwise, for `subjectId`, taken on by `assigneeId` when given. It is stored `confirmed`, with `sourceKind` `app` and the `operationId` as its `sourceRef`. The same command again returns the same item; `operationId` makes a retry safe. requestBody: required: true content: application/json: schema: type: object properties: operationId: type: string format: uuid at: type: string format: date-time title: type: string maxLength: 480 date: type: string maxLength: 10 pattern: ^\d{4}-\d{2}-\d{2}$ time: type: string maxLength: 20 subjectId: type: string maxLength: 64 pattern: >- ^per_[0-7][0123456789abcdefghjkmnpqrstvwxyz0123456789ABCDEFGHJKMNPQRSTVWXYZ]{25}$ assigneeId: type: string maxLength: 64 pattern: >- ^per_[0-7][0123456789abcdefghjkmnpqrstvwxyz0123456789ABCDEFGHJKMNPQRSTVWXYZ]{25}$ required: - operationId - at - title - date - subjectId responses: '201': description: The item, on its day. content: application/json: schema: type: object properties: item: $ref: '#/components/schemas/WeekItem' required: - item '400': description: >- The command is invalid (`routine.invalid-command`, with `details.field` and `details.fieldCode`), or the activity is not a one-off and cannot be removed (`routine.not-removable`). content: application/json: schema: $ref: '#/components/schemas/DomainError' '401': description: The session is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/Unauthorized' '403': description: The request came from another origin. content: application/json: schema: $ref: '#/components/schemas/Forbidden' '404': description: >- A person or the activity is not in the household (`routine.subject-not-found`, `routine.assignee-not-found`, `routine.activity-not-found`). content: application/json: schema: $ref: '#/components/schemas/DomainError' '409': description: >- `routine.operation-reused`: the `operationId` was used for another command; `routine.stale-schedule`: `supersedes` is no longer the current schedule. content: application/json: schema: $ref: '#/components/schemas/DomainError' '503': $ref: '#/components/responses/ServiceUnavailable' '504': $ref: '#/components/responses/RequestTimeout' security: - session: [] components: schemas: WeekItem: oneOf: - type: object properties: id: type: string activityId: type: string scheduleId: type: string date: type: string title: type: string subjects: type: array items: type: object properties: personId: type: string displayName: type: string required: - personId - displayName assignee: type: object nullable: true properties: personId: type: string displayName: type: string required: - personId - displayName mine: type: boolean confidence: type: string enum: - confirmed - assumed provenance: type: object properties: sourceKind: type: string enum: - text - app sourceRef: type: string authorId: type: string nullable: true appliedAt: type: string format: date-time quote: type: string nullable: true required: - sourceKind - sourceRef - authorId - appliedAt - quote suppressedBy: type: string enum: - exception - trip - vacation - holiday - school-calendar place: type: object properties: name: type: string address: type: string nullable: true mapUrl: type: string format: uri required: - name - address - mapUrl leaveAt: type: string reassignedFrom: type: object properties: personId: type: string displayName: type: string required: - personId - displayName reassignedBy: type: string kind: type: string enum: - event start: type: string required: - id - activityId - scheduleId - date - title - subjects - assignee - mine - confidence - provenance - kind - start - type: object properties: id: type: string activityId: type: string scheduleId: type: string date: type: string title: type: string subjects: type: array items: type: object properties: personId: type: string displayName: type: string required: - personId - displayName assignee: type: object nullable: true properties: personId: type: string displayName: type: string required: - personId - displayName mine: type: boolean confidence: type: string enum: - confirmed - assumed provenance: type: object properties: sourceKind: type: string enum: - text - app sourceRef: type: string authorId: type: string nullable: true appliedAt: type: string format: date-time quote: type: string nullable: true required: - sourceKind - sourceRef - authorId - appliedAt - quote suppressedBy: type: string enum: - exception - trip - vacation - holiday - school-calendar place: type: object properties: name: type: string address: type: string nullable: true mapUrl: type: string format: uri required: - name - address - mapUrl leaveAt: type: string reassignedFrom: type: object properties: personId: type: string displayName: type: string required: - personId - displayName reassignedBy: type: string kind: type: string enum: - untimed required: - id - activityId - scheduleId - date - title - subjects - assignee - mine - confidence - provenance - kind DomainError: type: object properties: code: type: string details: type: object additionalProperties: nullable: true required: - code - details Unauthorized: type: object properties: message: type: string enum: - Unauthorized statusCode: type: number enum: - 401 required: - message - statusCode Forbidden: type: object properties: message: type: string enum: - Forbidden statusCode: type: number enum: - 403 required: - message - statusCode Degraded: type: object properties: code: type: string enum: - request.timeout - service.unavailable correlationId: type: string required: - code - correlationId responses: ServiceUnavailable: description: A dependency is unavailable; retry after Retry-After seconds. content: application/json: schema: $ref: '#/components/schemas/Degraded' RequestTimeout: description: The request outlived its deadline. content: application/json: schema: $ref: '#/components/schemas/Degraded' securitySchemes: session: type: apiKey in: cookie name: __Secure-better-auth.session_token description: The session cookie set when you sign in to the web app. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.