gamification.challenge: fields, relations and API
The gamification.challenge model ("Gamification Challenge") is a persistent model declared by the Gamification module, then extended by 3 other modules. It exposes 45 fields, 26 of them declared directly on the model; 3 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.
Model identity
- Technical name
gamification.challenge- Label
- Gamification Challenge
- Type
- Persistent (models.Model)
- SQL table
gamification_challenge- Origin module
- Gamification (
gamification) - Extended by
- survey, website_slides, website_forum
- Default order (_order)
end_date, start_date, name, id- Inherits from (mixins)
- mail.thread
Model fields
26 own fields, 13 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
45 of 45 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| challenge_category | Appears in Define the visibility of the challenge through menus | selection | required Values: |
| description | Description | text | translatable |
| end_date | End Date The day a new challenge will be automatically closed. If no periodicity is set, will use this date as the goal end date. | date | |
| invited_user_ids | Suggest to users | many2many | |
| last_report_date | Last Report Date | date | |
| line_ids | Lines List of goals that will be set | one2many | required inverse: |
| manager_id | Responsible | many2one | |
| name | Challenge Name | char | requiredtranslatable |
| next_report_date | Next Report Date | date | computed, stored |
| period | Periodicity Period of automatic goal assignment. If none is selected, should be launched manually. | selection | required Values: |
| remind_update_delay | Non-updated manual goals will be reminded after Never reminded if no value or zero is specified. | integer | |
| report_message_frequency | Report Frequency | selection | required Values: |
| report_message_group_id | Send a copy to Group that will receive a copy of the report in addition to the user | many2one | |
| report_template_id | Report Template | many2one | required |
| reward_failure | Reward Bests if not Succeeded? | boolean | |
| reward_first_id | For 1st user | many2one | |
| reward_id | For Every Succeeding User | many2one | |
| reward_realtime | Reward as soon as every goal is reached With this option enabled, a user can receive a badge only once. The top 3 badges are still rewarded only at the end of the challenge. | boolean | |
| reward_second_id | For 2nd user | many2one | |
| reward_third_id | For 3rd user | many2one | |
| start_date | Start Date The day a new challenge will be automatically started. If no periodicity is set, will use this date as the goal start date. | date | |
| state | State | selection | required Values: |
| user_count | # Users | integer | computed |
| user_domain | User domain | char | |
| user_ids | Participants | many2many | |
| visibility_mode | Display Mode | selection | required Values: |
| has_message | Has Message | boolean | computed inherited from mail.thread |
| message_attachment_count | Attachment Count | integer | computed inherited from mail.thread |
| message_follower_ids | Followers | one2many | inverse: inherited from mail.thread |
| message_has_error | Message Delivery error If checked, some messages have a delivery error. | boolean | computed inherited from mail.thread |
| message_has_error_counter | Number of errors Number of messages with delivery error | integer | computed inherited from mail.thread |
| message_has_sms_error | SMS Delivery error If checked, some messages have a delivery error. | boolean | computed inherited from mail.thread |
| message_ids | Messages | one2many | inverse: inherited from mail.thread |
| message_is_follower | Is Follower | boolean | computed inherited from mail.thread |
| message_needaction | Action Needed If checked, new messages require your attention. | boolean | computed inherited from mail.thread |
| message_needaction_counter | Number of Actions Number of messages requiring action | integer | computed inherited from mail.thread |
| message_partner_ids | Followers (Partners) | many2many | computed inherited from mail.thread |
| rating_ids | Ratings | one2many | inverse: inherited from mail.thread |
| website_message_ids | Website Messages Website communication history | one2many | inverse: inherited from mail.thread |
| create_date | Created on | datetime | read-onlyautomatic |
| create_uid | Created by | many2one | read-onlyautomatic |
| display_name | Display Name | char | read-onlycomputedautomatic |
| id | ID | integer | read-onlyautomatic |
| write_date | Last Updated on | datetime | read-onlyautomatic |
| write_uid | Last Updated by | many2one | read-onlyautomatic |
Relations
Models linked from this model
- discuss.channel: report_message_group_id
- gamification.badge: reward_first_id, reward_id, reward_second_id, reward_third_id
- gamification.challenge.line: line_ids
- mail.template: report_template_id
- res.users: invited_user_ids, manager_id, user_ids
Fields of other models pointing here
- gamification.badge.user: challenge_id
- gamification.challenge.line: challenge_id
- gamification.goal: challenge_id
Reading this model through the API
Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.
curl -X POST "https://your-instance.odoo.com/json/2/gamification.challenge/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","challenge_category","period","report_message_frequency","report_template_id"],"limit":5}'import requests
BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}
res = requests.post(
f"{BASE_URL}/gamification.challenge/search_read",
headers=headers,
json={"domain": [], "fields": ["name","challenge_category","period","report_message_frequency","report_template_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())- External API access requires Odoo's Custom plan.
- XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
- The access rights and record rules of the key's user apply.
Cite this tool
Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.
<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/gamification-challenge">gamification.challenge (Odoo 19.0)</a>Sources
Data verified on September 23, 2026 · Odoo 19.0 Community
Have an Odoo project, or want to put your ERP to work with AI? Let's talk
Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.