List or Create User Quests | AISquare Studio

curl -X POST /api/v1/quests/my-quests/ \
     -H "Content-Type: application/json" \
     -d '{
  "quest": 42
}'

{
  "id": 42,
  "uid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "user": {
    "id": 7,
    "username": "johndoe",
    "email": "johndoe@example.com",
    "full_name": "John Doe",
    "is_verified": true,
    "details": [
      {
        "profile_picture": "https://example.com/images/johndoe.jpg",
        "bio": "Passionate software developer and AI enthusiast.",
        "country": "USA",
        "phone": "+1-555-123-4567",
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "github_url": "https://github.com/johndoe",
        "twitter_url": "https://twitter.com/johndoe",
        "website_url": "https://johndoe.dev",
        "top_domain_elo": 1520.5,
        "top_domain_rank": 12
      }
    ],
    "followers_count": 350
  },
  "quest": 42,
  "quest_details": {
    "id": 42,
    "uid": "9b2c1f4e-8d3a-4f7a-9a2b-1c2d3e4f5a6b",
    "name": "AI Fundamentals Challenge",
    "player_level": {
      "id": 3,
      "uid": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7g",
      "name": "Intermediate",
      "description": "Suitable for users with some experience in AI concepts.",
      "avg_score": 85
    },
    "created_by": {
      "id": 2,
      "username": "alicew",
      "email": "alicew@example.com",
      "full_name": "Alice Williams",
      "is_verified": true,
      "details": [
        {
          "profile_picture": "https://example.com/images/alicew.jpg",
          "bio": "AI researcher and educator.",
          "country": "Canada",
          "phone": "+1-416-555-7890",
          "linkedin_url": "https://linkedin.com/in/alicew",
          "github_url": "https://github.com/alicew",
          "twitter_url": "https://twitter.com/alicew",
          "website_url": "https://alicew.ai",
          "top_domain_elo": 1780.3,
          "top_domain_rank": 5
        }
      ],
      "followers_count": 1200
    },
    "co_creators": [
      {
        "id": 5,
        "username": "bobsmith",
        "email": "bobsmith@example.com",
        "full_name": "Bob Smith",
        "is_verified": true,
        "details": [
          {
            "profile_picture": "https://example.com/images/bobsmith.jpg",
            "bio": "Machine learning engineer and open source contributor.",
            "country": "UK",
            "phone": "+44-20-7946-0958",
            "linkedin_url": "https://linkedin.com/in/bobsmith",
            "github_url": "https://github.com/bobsmith",
            "twitter_url": "https://twitter.com/bobsmith",
            "website_url": "https://bobsmith.dev",
            "top_domain_elo": 1650.7,
            "top_domain_rank": 8
          }
        ],
        "followers_count": 800
      }
    ],
    "user_added_quest": true,
    "workspace_id": 101,
    "summary": "A comprehensive quest to master the basics of artificial intelligence.",
    "logo": "https://example.com/assets/ai-fundamentals-logo.png",
    "cover": "https://example.com/assets/ai-fundamentals-cover.jpg"
  },
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-04-20T14:45:00Z",
  "progress_percent": 75.5,
  "score": 88.7,
  "status": "in_progress",
  "completion_date": "2024-05-01T12:00:00Z",
  "certification_available": true
}

Lists all quests associated with the authenticated user or creates a new user quest.

Request

This endpoint expects an object.

userobjectRequired

questintegerRequired

quest_detailsobjectRequired

Mixin to add user_added_quest field to quest serializers

progress_percentdoubleOptional

progressanyOptional

scoredoubleOptional

statusenumOptional

not_started - Not Started
in_progress - In Progress
completed - Completed
failed - Failed

* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed

Allowed values:

completion_datedatetime or nullOptional

certification_availablebooleanOptional

Response

List of user quests

idintegerRead-only

uidstringRead-onlyformat: "uuid"

userobject

questinteger

quest_detailsobject

Mixin to add user_added_quest field to quest serializers

created_atdatetimeRead-only

updated_atdatetimeRead-only

progress_percentdouble

progressany

scoredouble

statusenum

not_started - Not Started
in_progress - In Progress
completed - Completed
failed - Failed

* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed

Allowed values:

completion_datedatetime or null

certification_availableboolean

Errors

400

Bad Request Error

401

Unauthorized Error