Skip to main content
GET
/
api
/
v1
/
workflow
/
{id}
Get agent workflow
curl --request GET \
  --url https://prod.featherhq.com/api/v1/workflow/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "active": true,
  "startHour": 123,
  "endHour": 123,
  "timezone": "<string>",
  "workflowSchedule": {
    "monday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 9,
          "startMinute": 0,
          "endHour": 17,
          "endMinute": 0
        }
      ]
    },
    "tuesday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 9,
          "startMinute": 0,
          "endHour": 17,
          "endMinute": 0
        }
      ]
    },
    "wednesday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 9,
          "startMinute": 0,
          "endHour": 17,
          "endMinute": 0
        }
      ]
    },
    "thursday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 9,
          "startMinute": 0,
          "endHour": 17,
          "endMinute": 0
        }
      ]
    },
    "friday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 9,
          "startMinute": 0,
          "endHour": 17,
          "endMinute": 0
        }
      ]
    },
    "saturday": {
      "enabled": false,
      "timeRanges": []
    },
    "sunday": {
      "enabled": false,
      "timeRanges": []
    }
  },
  "tcpaSchedule": {
    "monday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 8,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    },
    "tuesday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 8,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    },
    "wednesday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 8,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    },
    "thursday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 8,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    },
    "friday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 8,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    },
    "saturday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 8,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    },
    "sunday": {
      "enabled": true,
      "timeRanges": [
        {
          "startHour": 13,
          "startMinute": 0,
          "endHour": 21,
          "endMinute": 0
        }
      ]
    }
  },
  "definition": {
    "steps": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "type": "CALL",
        "order": 2,
        "delayInSecs": 0,
        "finishOn": [],
        "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "leaveVoicemail": false
      }
    ]
  },
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Authorizations

X-API-Key
string
header
required

Path Parameters

id
string<uuid>
required

Response

Agent workflow retrieved successfully

id
string<uuid>
required

Workflow ID

name
string
required

Workflow name

description
string | null
required

Workflow description

organizationId
string<uuid>
required

Organization ID

userId
string<uuid>
required

User ID who created the workflow

active
boolean
required

Whether the workflow is active

startHour
integer
required

Start hour (0-23) for backward compatibility

endHour
integer
required

End hour (0-23) for backward compatibility

timezone
string
required

Timezone for workflow execution and schedule interpretation

workflowSchedule
object | null
required

Workflow schedule - operates in workflow timezone

Example:
{
"monday": {
"enabled": true,
"timeRanges": [
{
"startHour": 9,
"startMinute": 0,
"endHour": 17,
"endMinute": 0
}
]
},
"tuesday": {
"enabled": true,
"timeRanges": [
{
"startHour": 9,
"startMinute": 0,
"endHour": 17,
"endMinute": 0
}
]
},
"wednesday": {
"enabled": true,
"timeRanges": [
{
"startHour": 9,
"startMinute": 0,
"endHour": 17,
"endMinute": 0
}
]
},
"thursday": {
"enabled": true,
"timeRanges": [
{
"startHour": 9,
"startMinute": 0,
"endHour": 17,
"endMinute": 0
}
]
},
"friday": {
"enabled": true,
"timeRanges": [
{
"startHour": 9,
"startMinute": 0,
"endHour": 17,
"endMinute": 0
}
]
},
"saturday": { "enabled": false, "timeRanges": [] },
"sunday": { "enabled": false, "timeRanges": [] }
}
tcpaSchedule
object | null
required

TCPA schedule - applies to borrower local timezone

Example:
{
"monday": {
"enabled": true,
"timeRanges": [
{
"startHour": 8,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
},
"tuesday": {
"enabled": true,
"timeRanges": [
{
"startHour": 8,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
},
"wednesday": {
"enabled": true,
"timeRanges": [
{
"startHour": 8,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
},
"thursday": {
"enabled": true,
"timeRanges": [
{
"startHour": 8,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
},
"friday": {
"enabled": true,
"timeRanges": [
{
"startHour": 8,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
},
"saturday": {
"enabled": true,
"timeRanges": [
{
"startHour": 8,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
},
"sunday": {
"enabled": true,
"timeRanges": [
{
"startHour": 13,
"startMinute": 0,
"endHour": 21,
"endMinute": 0
}
]
}
}
definition
object
required

Workflow definition

createdAt
string
required

Creation timestamp

updatedAt
string
required

Last update timestamp