Asana
Overzicht
Asana is een uitgebreid werkbeheersplatform dat teams helpt hun werk te organiseren, bij te houden en te beheren. Via de integratie van Langdock kunt u werkruimten, projecten, taken en teams rechtstreeks vanuit uw gesprekken beheren.
Authenticatie: OAuth Categorie: Productiviteit & Samenwerking Beschikbaarheid: Alle workspace-abonnementen
Beschikbare acties
Werkruimten & Teams
Werkruimten weergeven
asana.list_workspaces
Haal alle toegankelijke werkruimten in uw Asana-account op.
Vereist bevestiging: Ja
Parameters:
limit(nummer, optioneel): Beperk het aantal resultaten (1-100)optFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Toon al mijn Asana-werkruimten”
Teams ophalen voor werkruimte
asana.get_teams_for_workspace
Geef alle teams in een specifieke werkruimte weer.
Vereist bevestiging: Ja
Parameters:
workspaceGid(tekenreeks, vereist): Werkruimte GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven teams
Voorbeeldgebruik:
“Toon alle teams in werkruimte 12345”
Teams ophalen voor gebruiker
asana.get_teams_for_user
Haal teams op waarvan een gebruiker lid is.
Vereist bevestiging: Ja
Parameters:
userGid(tekenreeks, vereist): Gebruikersidentificatie (‘me’, e-mail of gebruikers-GID)organization(tekenreeks, vereist): Werkruimte- of organisatie-GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven teams
Voorbeeldgebruik:
“Toon alle teams waarvan ik lid ben in organisatie 12345”
Gebruikers
Gebruikers ophalen
asana.get_users
Lijst gebruikers in toegankelijke werkruimten; optioneel filteren op werkruimte of team.
Vereist bevestiging: Ja
Parameters:
workspace(tekenreeks, optioneel): Werkruimte GID om gebruikers te filterenteam(tekenreeks, optioneel): Team GID om gebruikers te filterenlimit(nummer, optioneel): Maximaal aantal terug te geven gebruikersoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Toon alle gebruikers in het Marketing-team”
Gebruiker ophalen
asana.get_user
Haal gebruikersgegevens op via ID, e-mail of “me”.
Vereist bevestiging: Ja
Parameters:
userId(tekenreeks, optioneel): Gebruikersidentificatie (‘me’, e-mail of gebruikers-GID)optFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal informatie op over de huidige gebruiker” of “Haal informatie op over gebruiker [email protected]”
Doelen
Doelen ophalen
asana.get_goals
Lijst doelen gefilterd op context (portfolio, project, taak, werkruimte of team).
Vereist bevestiging: Ja
Parameters:
workspace(tekenreeks, optioneel): Werkruimte GID om doelen te filterenteam(tekenreeks, optioneel): Team GID om doelen te filterenproject(tekenreeks, optioneel): Project GID om doelen te filterenportfolio(tekenreeks, optioneel): Portfolio GID om doelen te filterentask(tekenreeks, optioneel): Taak GID om doelen te filterentimePeriod(tekenreeks, optioneel): Tijdperiode-ID's om doelen te filterenisWorkspaceLevel(boolean, optioneel): Filter op doelen op werkruimteniveaulimit(nummer, optioneel): Maximaal aantal terug te geven doelenoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Toon alle doelen voor het Marketing-team”
Doel ophalen
asana.get_goal
Haal gedetailleerde doelgegevens op.
Vereist bevestiging: Ja
Parameters:
goalGid(tekenreeks, vereist): Doel GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal details op voor doel 12345”
Ouderdoelen ophalen voor doel
asana.get_parent_goals_for_goal
Lijst alle ouderdoelen voor een specifiek doel.
Vereist bevestiging: Ja
Parameters:
goalGid(tekenreeks, vereist): Doel GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Toon alle ouderdoelen voor doel 12345”
Projecten
Projecten ophalen
asana.get_projects
Lijst projecten gefilterd op werkruimte.
Vereist bevestiging: Ja
Parameters:
workspace(tekenreeks, vereist): Werkruimte GIDteam(tekenreeks, optioneel): Filter projecten op team-idarchived(boolean, optioneel): Inclusief gearchiveerde projectenlimit(nummer, optioneel): Maximaal aantal terug te geven projectenoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen. Voorbeeld:name,owner.name,workspace.name,team.name,archived,current_status.color
Voorbeeldgebruik:
“Toon alle actieve projecten in werkruimte 12345”
Projecten ophalen voor werkruimte
asana.get_projects_for_workspace
Haal ALLE projecten in een werkruimte op over alle teams heen.
Vereist bevestiging: Ja
Parameters:
workspaceGid(tekenreeks, vereist): Werkruimte GIDarchived(boolean, optioneel): Filter projecten op gearchiveerde statusoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven projecten
Voorbeeldgebruik:
“Haal alle projecten op in mijn marketing-werkruimte”
Projecten ophalen voor team
asana.get_projects_for_team
Lijst alle projecten voor een team.
Vereist bevestiging: Ja
Parameters:
teamGid(tekenreeks, vereist): Team GIDarchived(boolean, optioneel): Filter projecten op gearchiveerde statusoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven projecten
Voorbeeldgebruik:
“Toon alle projecten voor het Engineering-team”
Project ophalen
asana.get_project
Haal gedetailleerde projectgegevens op.
Vereist bevestiging: Ja
Parameters:
projectId(tekenreeks, vereist): Project GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal volledige details op voor project 12345”
Project taakaantallen ophalen
asana.get_project_task_counts
Haal taakstatistieken voor een project op.
Vereist bevestiging: Ja
Parameters:
projectId(tekenreeks, vereist): Project GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal taakaantallen op voor project 12345”
Project aanmaken
asana.create_project
Maak een nieuw project in Asana.
Vereist bevestiging: Ja
Parameters:
name(tekenreeks, vereist): Naam van het projectworkspace(tekenreeks, optioneel): Werkruimte GIDteam(tekenreeks, optioneel): Team GIDnotes(tekenreeks, optioneel): ProjectbeschrijvinghtmlNotes(tekenreeks, optioneel): HTML-geformatteerde beschrijvingowner(tekenreeks, optioneel): Gebruikersidentificatie (‘me’, e-mail of gebruikers-GID)followers(tekenreeks, optioneel): Door komma's gescheiden lijst van gebruikers-GIDscolor(tekenreeks, optioneel): ProjectkleurdueDate(tekenreeks, optioneel): Vervaldatum (JJJJ-MM-DD)startDate(tekenreeks, optioneel): Begindatum (JJJJ-MM-DD)defaultView(tekenreeks, optioneel): Standaardweergavepublic(boolean, optioneel): Openbaar voor werkruimtearchived(boolean, optioneel): Gearchiveerde statusisTemplate(boolean, optioneel): Is sjabloonprivacySetting(tekenreeks, optioneel): PrivacyniveaudefaultAccessLevel(tekenreeks, optioneel): StandaardtoegangsniveauminimumAccessLevelForSharing(tekenreeks, optioneel): Minimale toegangsniveau voor delenminimumAccessLevelForCustomization(tekenreeks, optioneel): Minimale toegangsniveau voor aanpassingcustomFields(tekenreeks, optioneel): JSON-tekenreeks van aangepaste veldenicon(tekenreeks, optioneel): Type projectpictogramoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Maak een nieuw project genaamd ‘Q1 Marketing Campaign’ in het Marketing-team”
Taken
Taken ophalen
asana.get_tasks
Lijst taken gefilterd op context (werkruimte/project/tag/sectie/gebruikerlijst).
Vereist bevestiging: Ja
Parameters:
workspace(tekenreeks, optioneel): Werkruimte GIDproject(tekenreeks, optioneel): Project GIDtag(tekenreeks, optioneel): Tag GIDsection(tekenreeks, optioneel): Sectie GIDassignee(tekenreeks, optioneel): Gebruikersidentificatie (‘me’, e-mail of gebruikers-GID)completedSince(tekenreeks, optioneel): Filter taken voltooid sinds datummodifiedSince(tekenreeks, optioneel): Filter taken gewijzigd sinds datumuserTaskList(tekenreeks, optioneel): Gebruikerstakenlijst GIDlimit(nummer, optioneel): Aantal terug te geven taken (1-100)offset(tekenreeks, optioneel): Paginatie offset-tokenoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Toon alle taken die aan mij zijn toegewezen in het Q4 Planning-project”
Taken doorzoeken
asana.search_tasks
Geavanceerd takenzoeken met meerdere filters.
Vereist bevestiging: Ja
Parameters omvatten (gedeeltelijke lijst):
workspace(tekenreeks, vereist): Werkruimte GIDtekst(tekenreeks, optioneel): Tekst om te zoeken in taaknaam of beschrijvingcompleted(boolean, optioneel): Filter voor voltooide of onvoltooide takenassigneeAny,assigneeNot,projectsAny,projectsAll,projectsNot(tekenreeks, optioneel): Door komma's gescheiden lijsten voor opname/uitsluitingtagsAny,tagsAll,tagsNot(tekenreeks, optioneel)sectionsAny,sectionsAll,sectionsNot(tekenreeks, optioneel)portfoliosAny,teamsAny,followersAny,followersNot(tekenreeks, optioneel)createdByAny,createdByNot,assignedByAny,assignedByNot(tekenreeks, optioneel)hasAttachment,isBlocked,isBlocking,isSubtask(boolean, optioneel)resourceSubtype(tekenreeks, optioneel)customFields(tekenreeks, optioneel): JSON-tekenreeks van filters voor aangepaste veldenDatum-/tijdfilters voor dueOn, dueAt, startOn, createdOn, modifiedOn, completedOn, createdAt, modifiedAt, completedAt (ISO 8601)
sortBy(tekenreeks, optioneel): Veld om op te sorteren (standaard op modified_at)sortAscending(boolean, optioneel): Standaard falselimit(nummer, optioneel): Aantal resultaten om terug te geven (1-100)optFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenoptPretty(boolean, optioneel): Mooie uitvoer met regeleinden en inspringing
Voorbeeldgebruik:
“Zoek naar alle taken die ‘budget review’ vermelden in de Finance-werkruimte” “Vind alle onvoltooide taken die aan mij zijn toegewezen en deze week vervallen”
Taak ophalen
asana.get_task
Haal volledige taakgegevens op via ID.
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal volledige details op voor taak 12345”
Taak aanmaken
asana.create_task
Maak taak aan in Asana met context.
Vereist bevestiging: Ja
Parameters:
name(tekenreeks, vereist): Naam van de taakworkspace(tekenreeks, optioneel): Werkruimte GIDprojectId(tekenreeks, optioneel): Project GIDparent(tekenreeks, optioneel): Ouder-taak GIDassignee(tekenreeks, optioneel): Gebruikersidentificatie (‘me’, e-mail of gebruikers-GID)followers(tekenreeks, optioneel): Door komma's gescheiden lijst van gebruikersidentificatiesnotes(tekenreeks, optioneel): TaakomschrijvinghtmlNotes(tekenreeks, optioneel): HTML-geformatteerde beschrijvingcompleted(boolean, optioneel): Markeer als voltooiddueOn(tekenreeks, optioneel): Vervaldatum (JJJJ-MM-DD)dueAt(tekenreeks, optioneel): Vervaldatum en -tijdstartOn(tekenreeks, optioneel): Begindatum (JJJJ-MM-DD)startAt(tekenreeks, optioneel): Begindatum en -tijdassigneeSection(tekenreeks, optioneel): Sectie GIDresourceSubtype(tekenreeks, optioneel): TaaktypeapprovalStatus(tekenreeks, optioneel): GoedkeuringsstatuscustomType(tekenreeks, optioneel): Aangepast type GIDcustomTypeStatusOption(tekenreeks, optioneel): GID van de statusoptie van het aangepaste typecustomFields(tekenreeks, optioneel): JSON-tekenreeks van aangepaste velden
Voorbeeldgebruik:
“Maak een taak ‘Review Q4 budget’ met vervaldatum 2024-03-15 en wijs deze toe aan [email protected]”
Taak bijwerken
asana.update_task
Werk bestaande taak-eigenschappen bij.
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDname(tekenreeks, optioneel): Taaknaamnotes(tekenreeks, optioneel): Taakomschrijvingassignee(tekenreeks, optioneel): Gebruikersidentificatie (‘me’, e-mail of gebruikers-GID)dueOn(tekenreeks, optioneel): Vervaldatum (JJJJ-MM-DD)dueAt(tekenreeks, optioneel): Vervaldatum en -tijdcompleted(boolean, optioneel): Markeer als voltooidcustomFields(tekenreeks, optioneel): JSON-tekenreeks van aangepaste velden
Voorbeeldgebruik:
“Markeer taak 123456 als voltooid en werk de notities bij”
Ouder instellen voor taak
asana.set_parent_for_task
Wijzig ouder van taak (converteer naar/van subtaak).
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDparent(tekenreeks, vereist): Ouder-taak GIDinsertBefore(tekenreeks, optioneel): Invoegen vóór taak GIDinsertAfter(tekenreeks, optioneel): Invoegen na taak GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Maak taak 12345 een subtaak van taak 67890”
Taakafhankelijkheden instellen
asana.set_task_dependencies
Stel taken in waarvan deze taak afhankelijk is (vereisten).
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDdependencies(object, vereist): Array van taak-GIDs
Voorbeeldgebruik:
“Stel in dat taak 12345 afhankelijk is van taken 67890 en 11111”
Taakafhankelijken instellen
asana.set_task_dependents
Stel taken in die door deze taak worden geblokkeerd (taken die op deze wachten).
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDdependents(object, vereist): Array van taak-GIDs
Voorbeeldgebruik:
“Stel in dat taken 67890 en 11111 wachten op taak 12345”
Volgers toevoegen aan taak
asana.add_task_followers
Voeg volgers toe aan taak (teamleden die over updates geïnformeerd worden).
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDfollowers(tekenreeks, vereist): Door komma's gescheiden lijst van gebruikersidentificaties
Voorbeeldgebruik:
“Voeg [email protected] en [email protected] toe als volgers van taak 12345”
Volgers verwijderen van taak
asana.remove_task_followers
Verwijder volgers van taak (stop notificatie-abonnementen).
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDfollowers(tekenreeks, vereist): Door komma's gescheiden lijst van gebruikersidentificatiesoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Verwijder [email protected] van het volgen van taak 12345”
Stories & Opmerkingen
Stories ophalen voor taak
asana.get_stories_for_task
Haal taak-activiteitshistorie op (reacties, statuswijzigingen, systeemgebeurtenissen).
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDlimit(nummer, optioneel): Aantal stories om terug te geven (1-100)optFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Toon alle opmerkingen en activiteiten voor taak 12345”
Story ophalen
asana.get_story
Haal een enkele story op via GID.
Vereist bevestiging: Ja
Parameters:
storyGid(tekenreeks, vereist): Story GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal details op voor story 12345”
Taakreactie aanmaken
asana.create_task_story
Voeg een expliciet commentaar toe aan een taak.
Vereist bevestiging: Ja
Parameters:
taskId(tekenreeks, vereist): Taak GIDtekst(tekenreeks, vereist): CommentaartekstoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Voeg een opmerking toe aan taak 12345 met de tekst ‘Dit ziet er goed uit voor mij’”
Tags
Tags ophalen in werkruimte
asana.get_tags_in_workspace
Geeft compacte tagrecords terug gefilterd op werkruimte.
Vereist bevestiging: Ja
Parameters:
workspaceGid(tekenreeks, vereist): Werkruimte GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven tags
Voorbeeldgebruik:
“Toon alle tags in de Marketing-werkruimte”
Bijlagen
Bijlagen ophalen voor object
asana.get_attachments_for_object
Lijst bijlage-ID's en metadata voor een project, taak of projectbrief (geen download).
Vereist bevestiging: Ja
Parameters:
parent(tekenreeks, vereist): Project- of taak-GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven bijlagen
Voorbeeldgebruik:
“Lijst alle bijlagen voor taak 12345”
Bijlage downloaden
asana.download_attachment
Haal gedetailleerde bijlagegegevens op inclusief naam, resourcetype, download_url, view_url en ouder.
Vereist bevestiging: Ja
Parameters:
attachmentGid(tekenreeks, vereist): Bijlage GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal download-URL op voor bijlage 12345”
Bijlagen downloaden voor object
asana.download_attachments_for_object
Download alle bijlagen voor een project, taak of projectbrief.
Vereist bevestiging: Ja
Parameters:
parent(tekenreeks, vereist): Project- of taak-GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven bijlagen
Voorbeeldgebruik:
“Download alle bijlagen voor project 12345”
Portfolio's
Portfolio's ophalen
asana.get_portfolios
Lijst portfolio's gefilterd op werkruimte, eigenaar of team.
Vereist bevestiging: Ja
Parameters:
owner(tekenreeks, vereist): Gebruikersidentificatie (‘me’ of gebruikers-GID)workspace(tekenreeks, optioneel): Werkruimte GIDteam(tekenreeks, optioneel): Team GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal terug te geven portfolio's
Voorbeeldgebruik:
“Toon alle portfolio's die ik bezit in werkruimte 12345”
Portfolio ophalen
asana.get_portfolio
Haal gedetailleerde portfoliogegevens op via ID.
Vereist bevestiging: Ja
Parameters:
portfolioGid(tekenreeks, vereist): Portfolio GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemen
Voorbeeldgebruik:
“Haal volledige details op voor portfolio 12345”
Portfolio-items ophalen
asana.get_portfolio_items
Haal de items in een portfolio op in compacte vorm.
Vereist bevestiging: Ja
Parameters:
portfolioGid(tekenreeks, vereist): Portfolio GIDoptFields(tekenreeks, optioneel): Door komma's gescheiden velden om op te nemenlimit(nummer, optioneel): Maximaal aantal items om terug te geven
Voorbeeldgebruik:
“Toon alle items in portfolio 12345”
Zoeken
Typeahead-zoeken
asana.typeahead_search
Snelle zoekopdracht over Asana-objecten.
Vereist bevestiging: Ja
Parameters:
workspaceGid(tekenreeks, vereist): Werkruimte GIDresourceType(tekenreeks, vereist): Resourcetype om te doorzoekenquery(tekenreeks, optioneel): Zoekopdrachtcount(nummer, optioneel): Aantal resultaten om terug te geven (1-100)
Voorbeeldgebruik:
“Snelle zoekopdracht naar projecten die overeenkomen met ‘marketing’ in werkruimte 12345”
Veelvoorkomende gebruikssituaties
Projectbeheer
Maak en organiseer projecten
Volg projectvoortgang
Beheer projecttijdlijnen
Taaktracking
Maak en wijs taken toe
Werk taakstatus bij
Stel vervaldatums en prioriteiten in
Team samenwerking
Organiseer teams en werkruimten
Ken werk toe aan teamleden
Volg teamproductiviteit
Workflow-automatisering
Zoek en filter taken
Bulk bijwerken van taak-eigenschappen
Genereer statusrapporten
Beste praktijken
Prestatie-tips:
Gebruik
limitparameter om de resultaatgrootte te regelenGebruik
optFieldsom datatransfer te verminderenCache werkruimte- en project-GIDs voor herhaald gebruik
Gebruik zoeken voor complexe filterbehoeften
Belangrijke overwegingen:
GIDs zijn permanente unieke identificatoren
Vervaldatums moeten in JJJJ-MM-DD-formaat zijn
Voltooide taken blijven in het systeem
Snelheidslimieten gelden per OAuth-token
Workflow-voorbeelden
Probleemoplossing
"Werkruimte niet gevonden"
Verifieer werkruimte-GID met Werkruimten weergeven
"Ongeldig datumformaat"
Gebruik JJJJ-MM-DD-formaat voor datums
"Toegang geweigerd"
Controleer OAuth-token machtigingen
"Taak niet gevonden"
Zorg dat taak-GID correct is en toegankelijk
Gerelateerde integraties
Jira - Voor softwareontwikkelingstracking
Linear - Voor moderne issue-tracking
Monday.com - Voor visueel werkbeheer
Ondersteuning
Voor extra hulp met de Asana-integratie, neem contact op met [email protected]

