Asana · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Asana Time Tracking Entries API

6 actions 6 updates phrasing extends openapi/asana-time-tracking-entries-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Asana's API. It is a proposal applied on top of the contract, not a document Asana publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info

$.paths['/tasks/{task_gid}/time_tracking_entries'].get

$.paths['/tasks/{task_gid}/time_tracking_entries'].post

$.paths['/time_tracking_entries/{time_tracking_entry_gid}'].get

$.paths['/time_tracking_entries/{time_tracking_entry_gid}'].put

$.paths['/time_tracking_entries/{time_tracking_entry_gid}'].delete

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Asana Time Tracking Entries API
  version: 1.0.0
extends: openapi/asana-time-tracking-entries-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/tasks/{task_gid}/time_tracking_entries'].get
  update:
    x-apievangelist-phrasing:
      intent: List time logged on a task
      effect: read
      questions:
      - How much time has been logged against a task?
      - Can I see each time entry recorded on a task?
      instructions:
      - text: List time tracking entries for task {task}.
        slots:
          task: path.task_gid
      - text: Show the time logged on task {task}.
        slots:
          task: path.task_gid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/tasks/{task_gid}/time_tracking_entries'].post
  update:
    x-apievangelist-phrasing:
      intent: Log time on a task
      effect: write
      questions:
      - How do I log time I spent on a task?
      - Can I log time against a task for someone's work today?
      instructions:
      - text: Log {duration} on task {task}.
        slots:
          task: path.task_gid
          duration: requestBody.data
      - text: Record a time entry on task {task} with {details}.
        slots:
          task: path.task_gid
          details: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/time_tracking_entries/{time_tracking_entry_gid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a time tracking entry
      effect: read
      questions:
      - What does a single time entry record show?
      - Can I look up who logged a time entry and when?
      instructions:
      - text: Show time tracking entry {entry}.
        slots:
          entry: path.time_tracking_entry_gid
      - text: Fetch the details of time entry {entry}.
        slots:
          entry: path.time_tracking_entry_gid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/time_tracking_entries/{time_tracking_entry_gid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a time tracking entry
      effect: write
      questions:
      - Can I correct the duration on a time entry I logged?
      - Can I fix the details of a time entry after logging it?
      instructions:
      - text: Change time entry {entry} duration to {duration}.
        slots:
          entry: path.time_tracking_entry_gid
          duration: requestBody.data
      - text: Update time tracking entry {entry} with {changes}.
        slots:
          entry: path.time_tracking_entry_gid
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/time_tracking_entries/{time_tracking_entry_gid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a time tracking entry
      effect: destructive
      questions:
      - Can I delete time I logged by mistake?
      - What does deleting a time entry return?
      instructions:
      - text: Delete time tracking entry {entry}.
        slots:
          entry: path.time_tracking_entry_gid
      - text: Remove the time entry {entry}.
        slots:
          entry: path.time_tracking_entry_gid
      method: generated
      generated: '2026-10-01'