---
title: "POST /users/me/rate_later/{poll_name}/"
method: POST
path: "/users/me/rate_later/{poll_name}/"
tags: ["users"]
---

# POST /users/me/rate_later/{poll_name}/

`POST /users/me/rate_later/{poll_name}/`

## Request

- The document declares no server URL.
- Auth: OAuth 2
  - Password
  - Token URL: `http://127.0.0.1:8000/o/token/` scopes: `read write groups`

Add a new entity to the logged user's rate-later list, for a given poll.

## Path parameters

- `poll_name` string, required

## Query parameters

- `entity_seen` string

## Request body

- RateLaterRequest
  - `entity` RelatedEntityRequest, required: An Entity serializer that will lookup and possibly create the Entity object on validation, if it does not exist in the database yet. Only the field `uid` is provided when using write HTTP methods. Used by ModelSerializer(s) having one or more nested relations with Entity, and having the constraint to ensure that entity instances exist before they can be saved properly.
    - `uid` string, required

## Response `200`

- RateLater
  - `entity` RelatedEntity, required: An Entity serializer that will lookup and possibly create the Entity object on validation, if it does not exist in the database yet. Only the field `uid` is provided when using write HTTP methods. Used by ModelSerializer(s) having one or more nested relations with Entity, and having the constraint to ensure that entity instances exist before they can be saved properly.
    - `uid` string, required
    - `type` 'video' | 'candidate_fr_2022', required: * `video` - Video * `candidate_fr_2022` - Candidate (FR 2022)
    - `metadata` object, required
  - `collective_rating` CollectiveRating, required
    - `n_comparisons` integer, required: Total number of pairwise comparisons for this entityfrom certified contributors
    - `n_contributors` integer, required: Total number of certified contributors who rated the entity
    - `tournesol_score` number, double, nullable, required: The aggregated score of the main criterion for all users, in a specific poll.
    - `unsafe` UnsafeStatus, required
      - `status` boolean, required
      - `reasons` ReasonsEnum[], required
  - `individual_rating` IndividualRating, required
    - `is_public` boolean, required: Should the rating be public?
    - `entity_seen` boolean, required: Has the user already seen, or read, or understood the entity?
    - `n_comparisons` integer, required
  - `entity_contexts` EntityContext[], required
    - `origin` 'ASSOCIATION' | 'CONTRIBUTORS': * `ASSOCIATION` - Association * `CONTRIBUTORS` - Contributors
    - `unsafe` boolean: If True, this context will make the targeted entities unsafe.
    - `text` string, required
    - `created_at` string, date-time, required
  - `rate_later_metadata` RateLaterMetadata, required
    - `created_at` string, date-time, required: Time at which the video is saved.

## Other responses

- `409`: The entity is already in the user's rate-later list of this poll, or there is an other error with the database query.

## Changes

- **2026-01-24** `6ac30ab115c6`: 1 info
  - added the new optional `query` request parameter `entity_seen`
- **2025-08-19** `09b6010f79c7`: 1 info
  - added the required property `individual_rating/allOf[#/components/schemas/IndividualRating]/entity_seen` to the response with the `200` status
- **2023-11-30** `8aeda769b4b8`: 1 info
  - added the required property `entity_contexts` to the response with the `200` status
- **2023-11-30** `834066e5d795`: 1 warning
  - added the new `moderation_by_contributors` enum value to the `collective_rating/allOf[#/components/schemas/CollectiveRating]/unsafe/allOf[#/components/schemas/UnsafeStatus]/reasons/items/` response property for the response status `200`
- **2023-11-22** `8e45c6d6f248`: 1 warning
  - added the new `moderation_by_association` enum value to the `collective_rating/allOf[#/components/schemas/CollectiveRating]/unsafe/allOf[#/components/schemas/UnsafeStatus]/reasons/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/users/me/rate_later/:poll_name/post.md)

---

[API](https://skmtc.dev/tournesol-app/apis/tournesol-api.md) - [All operations](https://skmtc.dev/tournesol-app/apis/tournesol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tournesol-app/apis/tournesol-api/revisions/96c8c62ad972?raw)