Skip to content
Merged
183 changes: 183 additions & 0 deletions apps/docs/content/docs/en/integrations/asana.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -209,4 +209,187 @@ Add a comment (story) to an Asana task
| ↳ `gid` | string | Author GID |
| ↳ `name` | string | Author name |

### `asana_create_subtask`

Create a subtask under an existing Asana task

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | Yes | GID of the parent Asana task \(numeric string\) |
| `name` | string | Yes | Name of the subtask |
| `notes` | string | No | Notes or description for the subtask |
| `assignee` | string | No | User GID to assign the subtask to |
| `due_on` | string | No | Due date in YYYY-MM-DD format |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Subtask globally unique identifier |
| `name` | string | Subtask name |
| `notes` | string | Subtask notes or description |
| `completed` | boolean | Whether the subtask is completed |
| `created_at` | string | Subtask creation timestamp |
| `permalink_url` | string | URL to the subtask in Asana |

### `asana_delete_task`

Delete an Asana task by its GID (moves it to the trash)

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | Yes | GID of the Asana task to delete \(numeric string\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | GID of the deleted task |
| `deleted` | boolean | Whether the task was deleted |

### `asana_add_followers`

Add one or more followers to an Asana task

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | Yes | GID of the Asana task \(numeric string\) |
| `followers` | array | Yes | Array of user GIDs to add as followers to the task |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Task globally unique identifier |
| `name` | string | Task name |
| `followers` | array | Current followers on the task after the update |
| ↳ `gid` | string | Follower GID |
| ↳ `name` | string | Follower name |

### `asana_create_project`

Create a new project in an Asana workspace

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Yes | Asana workspace GID \(numeric string\) where the project will be created |
| `name` | string | Yes | Name of the project |
| `notes` | string | No | Notes or description for the project |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Project globally unique identifier |
| `name` | string | Project name |
| `notes` | string | Project notes or description |
| `archived` | boolean | Whether the project is archived |
| `color` | string | Project color |
| `created_at` | string | Project creation timestamp |
| `modified_at` | string | Project last modified timestamp |
| `permalink_url` | string | URL to the project in Asana |

### `asana_get_project`

Retrieve a single Asana project by its GID

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectGid` | string | Yes | Asana project GID \(numeric string\) to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Project globally unique identifier |
| `name` | string | Project name |
| `notes` | string | Project notes or description |
| `archived` | boolean | Whether the project is archived |
| `color` | string | Project color |
| `created_at` | string | Project creation timestamp |
| `modified_at` | string | Project last modified timestamp |
| `permalink_url` | string | URL to the project in Asana |

### `asana_list_workspaces`

List all Asana workspaces and organizations the authenticated user belongs to

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `workspaces` | array | Array of workspaces |
| ↳ `gid` | string | Workspace GID |
| ↳ `name` | string | Workspace name |
| ↳ `resource_type` | string | Resource type \(workspace\) |

### `asana_create_section`

Create a new section in an Asana project

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectGid` | string | Yes | GID of the Asana project \(numeric string\) to add the section to |
| `name` | string | Yes | Name of the section |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `gid` | string | Section globally unique identifier |
| `name` | string | Section name |
| `created_at` | string | Section creation timestamp |

### `asana_list_sections`

List all sections in an Asana project

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `projectGid` | string | Yes | GID of the Asana project \(numeric string\) to list sections from |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `success` | boolean | Operation success status |
| `ts` | string | Timestamp of the response |
| `sections` | array | Array of sections in the project |
| ↳ `gid` | string | Section GID |
| ↳ `name` | string | Section name |
| ↳ `resource_type` | string | Resource type \(section\) |


16 changes: 9 additions & 7 deletions apps/docs/content/docs/en/integrations/context_dev.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Scrape any URL and return the raw HTML content of the page.
| --------- | ---- | ----------- |
| `html` | string | Raw HTML content of the page |
| `url` | string | The scraped URL |
| `type` | string | Detected content type \(html, xml, json, text, csv, markdown, svg, pdf\) |
| `type` | string | Detected content type \(html, xml, json, text, csv, markdown, svg, pdf, doc, docx\) |

### `context_dev_scrape_images`

Expand Down Expand Up @@ -177,7 +177,7 @@ Build a sitemap of a domain and return every discovered page URL.
| --------- | ---- | ----------- |
| `domain` | string | The domain that was mapped |
| `urls` | array | All page URLs discovered from the sitemap |
| `meta` | object | Sitemap discovery stats \(sitemapsDiscovered, sitemapsFetched, errors\) |
| `meta` | object | Sitemap discovery stats \(sitemapsDiscovered, sitemapsFetched, sitemapsSkipped, errors\) |

### `context_dev_search`

Expand All @@ -191,6 +191,8 @@ Search the web with natural language and optionally scrape results to markdown.
| `includeDomains` | array | No | Only return results from these domains |
| `excludeDomains` | array | No | Exclude results from these domains |
| `freshness` | string | No | Recency filter \(last_24_hours, last_week, last_month, last_year\) |
| `numResults` | number | No | Number of results to return \(10-100, default 10\) |
| `country` | string | No | Restrict results to a country \(ISO 3166-1 alpha-2 code, e.g. US\) |
| `queryFanout` | boolean | No | Expand the query into parallel variants for broader coverage |
| `markdownEnabled` | boolean | No | Scrape each result page to markdown \(default: false\) |
| `timeoutMS` | number | No | Request timeout in milliseconds \(1000-300000\) |
Expand Down Expand Up @@ -449,7 +451,7 @@ Retrieve brand data for a domain: logos, colors, backdrops, socials, address, an
| ↳ `email` | string | Brand contact email |
| ↳ `phone` | string | Brand contact phone |
| ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
| ↳ `primary_language` | string | Primary language of the brand site |

### `context_dev_get_brand_by_name`
Expand Down Expand Up @@ -488,7 +490,7 @@ Retrieve brand data by company name: logos, colors, socials, address, and indust
| ↳ `email` | string | Brand contact email |
| ↳ `phone` | string | Brand contact phone |
| ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
| ↳ `primary_language` | string | Primary language of the brand site |

### `context_dev_get_brand_by_email`
Expand Down Expand Up @@ -526,7 +528,7 @@ Retrieve brand data from a work email address. Free/disposable emails are reject
| ↳ `email` | string | Brand contact email |
| ↳ `phone` | string | Brand contact phone |
| ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
| ↳ `primary_language` | string | Primary language of the brand site |

### `context_dev_get_brand_by_ticker`
Expand Down Expand Up @@ -565,7 +567,7 @@ Retrieve brand data for a public company by its stock ticker symbol.
| ↳ `email` | string | Brand contact email |
| ↳ `phone` | string | Brand contact phone |
| ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
| ↳ `primary_language` | string | Primary language of the brand site |

### `context_dev_get_brand_simplified`
Expand Down Expand Up @@ -632,7 +634,7 @@ Identify the brand behind a raw bank/card transaction descriptor and return its
| ↳ `email` | string | Brand contact email |
| ↳ `phone` | string | Brand contact phone |
| ↳ `industries` | json | Industry taxonomy \(eic industry/subindustry pairs\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing\) |
| ↳ `links` | json | Key brand links \(careers, privacy, terms, blog, pricing, contact\) |
| ↳ `primary_language` | string | Primary language of the brand site |

### `context_dev_prefetch_domain`
Expand Down
Loading
Loading