SHshiprush
Me

List pending tasks assigned to the current user

The Me API provides access to current user information, assigned records, and pending tasks. This endpoint serves as the primary interface for user-specific data and personal workspace functionality.

Core Functionality:

  • User Profile - Current user information including accounts and permissions
  • Assigned Records - All records assigned to the current user across different types
  • Task Management - Pending tasks assigned to the current user

User Context:

  • All endpoints return data scoped to the authenticated user
  • Account context is automatically determined from user session
  • Permissions are enforced based on user roles and project access

Response Structure:

  • User profile includes account memberships and role information
  • Assigned records include features, epics, requirements, ideas, releases, and tasks
  • Task lists include status information and completion tracking

Authentication: Standard API authentication (OAuth, session cookies, HTTP Basic until 2025). All operations require valid authentication and return user-specific data.

get/me/tasks

Request

  • Base URL
    https://company.aha.io/api/v1
  • Auth
    • OAuth 2
      Authorization codehttps://{account-domain}.aha.io/oauth/authorize
      Token URLhttps://{account-domain}.aha.io/oauth/token
    • or HTTP bearer
    • or API key in cookie session
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

pagestring
per_pagestring

Response

Successful operation

Example response

{
  "tasks": [
    {
      "id": "6776881149494751081",
      "name": "Review first widget",
      "due_date": null,
      "status": "pending",
      "created_at": "2019-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.