v1Resources/Approvals/getList task owners
List task owners
Returns the people who can own a task in Tasks & Approvals: agency teammates with access to Tasks & Approvals, and active client users. A task has one owner, the person responsible for getting it done. Pass clientId to get the owners for one client. Without clientId, you get the client users of every client the key can reach, each tagged with its clientId, and teammates are listed only when both the key and the person who created it have access to all clients. Requests run as the person who created the API key. If Tasks & Approvals isn't turned on for your workspace, this returns 404.
get
approvals:read/api/v1/work-management/ownersQuery parameters
clientIdstringoptional
Limit the list to one client. With a key that can reach all clients, this accepts the client's id, public id or slug, and a client the key's creator can't access returns 404. With a key limited to specific clients, pass the client's id; any other value, or a client outside the key's access, returns 403.
Response
okbooleanoptional
Always true on a successful response.
clientIdstringoptional
The client's id when you passed clientId, otherwise null.
ownersarray of objectoptional
People who can own a task: teammates first, then client users.
idstringoptional
The person's id. Pass it as ownerId when you create a task, or as userId when you set an owner.
namestringoptional
The person's display name.
typestring (user | client_user)optional
user for an agency teammate, client_user for a person from a client. Send the same value as ownerType.
clientIdstringoptional
The client this client user belongs to. Only on client users.
emailstringoptional
The client user's email address, or null. Only on client users.
Errors
401Missing, invalid, expired, or revoked API key.
403Tasks & Approvals errors come back as ok: false with an error object holding code, message, retryable and details. Errors from the API key check itself (a missing or invalid key, a missing scope, the rate limit) use the standard error shape, where error is a string.
404Tasks & Approvals errors come back as ok: false with an error object holding code, message, retryable and details. Errors from the API key check itself (a missing or invalid key, a missing scope, the rate limit) use the standard error shape, where error is a string.
429Too many requests. Retry after the number of seconds in the Retry-After header.
500The request couldn't be completed because of a problem on our side.
get/api/v1/work-management/owners
Your API key
clientId
{}