Asana Project

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://developers.asana.com/schemas/project",
  "title": "Asana Project",
  "description": "A project represents a prioritized list of tasks in Asana or a board with columns of tasks represented as cards. It exists in a single workspace or organization.",
  "type": "object",
  "properties": {
    "gid": {
      "type": "string",
      "description": "Globally unique identifier of the resource.",
      "readOnly": true,
      "examples": ["12345"]
    },
    "resource_type": {
      "type": "string",
      "const": "project",
      "description": "The base type of this resource.",
      "readOnly": true
    },
    "name": {
      "type": "string",
      "description": "Name of the project.",
      "examples": ["Stuff to buy"]
    },
    "archived": {
      "type": "boolean",
      "description": "True if the project is archived."
    },
    "color": {
      "type": ["string", "null"],
      "enum": [
        "dark-pink", "dark-green", "dark-blue", "dark-red", "dark-teal",
        "dark-brown", "dark-orange", "dark-purple", "dark-warm-gray",
        "light-pink", "light-green", "light-blue", "light-red", "light-teal",
        "light-brown", "light-orange", "light-purple", "light-warm-gray",
        "none", null
      ],
      "description": "Color of the project."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "The time at which this resource was created.",
      "readOnly": true
    },
    "modified_at": {
      "type": "string",
      "format": "date-time",
      "description": "The time at which this project was last modified.",
      "readOnly": true
    },
    "due_on": {
      "type": ["string", "null"],
      "format": "date",
      "description": "The day on which this project is due (YYYY-MM-DD)."
    },
    "start_on": {
      "type": ["string", "null"],
      "format": "date",
      "description": "The day on which work begins for this project (YYYY-MM-DD)."
    },
    "default_view": {
      "type": "string",
      "enum": ["list", "board", "calendar", "timeline"],
      "description": "The default view of a project."
    },
    "notes": {
      "type": "string",
      "description": "Free-form textual information associated with the project."
    },
    "html_notes": {
      "type": "string",
      "description": "The notes of the project with formatting as HTML."
    },
    "privacy_setting": {
      "type": "string",
      "enum": ["public_to_workspace", "private_to_team", "private"],
      "description": "The privacy setting of the project."
    },
    "default_access_level": {
      "type": "string",
      "enum": ["admin", "editor", "commenter", "viewer"],
      "description": "The default access for users or teams who join the project."
    },
    "completed": {
      "type": "boolean",
      "description": "True if the project is currently marked complete.",
      "readOnly": true
    },
    "completed_at": {
      "type": ["string", "null"],
      "format": "date-time",
      "description": "The time at which this project was completed.",
      "readOnly": true
    },
    "owner": {
      "oneOf": [
        { "$ref": "#/$defs/UserCompact" },
        { "type": "null" }
      ],
      "description": "The current owner of the project."
    },
    "team": {
      "$ref": "#/$defs/TeamCompact",
      "description": "The team that this project is shared with."
    },
    "workspace": {
      "$ref": "#/$defs/WorkspaceCompact",
      "description": "The workspace or organization this project is associated with.",
      "readOnly": true
    },
    "members": {
      "type": "array",
      "items": { "$ref": "#/$defs/UserCompact" },
      "description": "Array of users who are members of this project.",
      "readOnly": true
    },
    "followers": {
      "type": "array",
      "items": { "$ref": "#/$defs/UserCompact" },
      "description": "Array of users following this project.",
      "readOnly": true
    },
    "icon": {
      "type": ["string", "null"],
      "description": "The icon for a project."
    },
    "permalink_url": {
      "type": "string",
      "format": "uri",
      "description": "A URL that points directly to the object within Asana.",
      "readOnly": true
    }
  },
  "required": ["gid", "resource_type"],
  "$defs": {
    "UserCompact": {
      "type": "object",
      "properties": {
        "gid": { "type": "string" },
        "resource_type": { "type": "string", "const": "user" },
        "name": { "type": "string" }
      }
    },
    "TeamCompact": {
      "type": "object",
      "properties": {
        "gid": { "type": "string" },
        "resource_type": { "type": "string", "const": "team" },
        "name": { "type": "string" }
      }
    },
    "WorkspaceCompact": {
      "type": "object",
      "properties": {
        "gid": { "type": "string" },
        "resource_type": { "type": "string", "const": "workspace" },
        "name": { "type": "string" }
      }
    }
  }
}