openapi: 3.2.0
info:
  title: Sketchfab Data Likes API
  description: 'The Sketchfab Data API v3 provides programmatic read and write access to Sketchfab content. Authenticated callers can upload new 3D models, edit model metadata and settings, manage collections, comments, likes, and bookmarks, search the public model catalog, and administer organizations and projects. Public endpoints (model search, model detail, user profile) are available without authentication.

    '
  version: v3
  contact:
    name: Sketchfab Developer Support
    url: https://support.fab.com/s/?ProductOrigin=Sketchfab
  license:
    name: Sketchfab Developer Terms of Use
    url: https://sketchfab.com/developers/terms
servers:
- url: https://api.sketchfab.com
  description: Production API
security:
- OAuth2: []
- ApiTokenAuth: []
tags:
- name: Likes
  description: Likes (favorites) on a model.
paths:
  /v3/models/{uid}/likes:
    post:
      summary: Like A Model
      description: Like the model on behalf of the authenticated user.
      operationId: likeModel
      tags:
      - Likes
      parameters:
      - $ref: '#/components/parameters/ModelUid'
      responses:
        '201':
          description: Like created.
        '401':
          $ref: '#/components/responses/Error'
    delete:
      summary: Unlike A Model
      description: Remove the authenticated user's like for the model.
      operationId: unlikeModel
      tags:
      - Likes
      parameters:
      - $ref: '#/components/parameters/ModelUid'
      responses:
        '204':
          description: Like removed.
components:
  responses:
    Error:
      description: Error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  parameters:
    ModelUid:
      name: uid
      in: path
      required: true
      description: Sketchfab model UID (hex string in the URL after /models/).
      schema:
        type: string
  schemas:
    Error:
      type: object
      properties:
        detail:
          type: string
        code:
          type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      description: Sketchfab OAuth 2.0. Access tokens are valid for one month.
      flows:
        authorizationCode:
          authorizationUrl: https://sketchfab.com/oauth2/authorize/
          tokenUrl: https://sketchfab.com/oauth2/token/
          refreshUrl: https://sketchfab.com/oauth2/token/
          scopes:
            read: Read access to the caller's account, models, and collections.
            write: Create, update, and delete the caller's models and collections.
    ApiTokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Personal API token sent as `Authorization: Token <token>`.'