Me API

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.

Reject request without authentication

GET /api/v1/me/assigned

Returns unauthorized error when no authentication credentials are provided

Example request

GET /api/v1/me/assigned

Example CURL command

curl -g "https://company.aha.io/api/v1/me/assigned" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Authorization: "

Request

contentType: application/json
accept: application/json
authorization:

Response

Status: 401 Unauthorized
contentType: text/html