Skip to content
Merged
11 changes: 7 additions & 4 deletions apps/docs/content/docs/integrations/datadog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Query metric timeseries data from Datadog. Use for analyzing trends, creating re

### Datadog Create Event

Post an event to the Datadog event stream. Use for deployment notifications, alerts, or any significant occurrences.
Post an event to the Datadog event stream. Use for deployment notifications, alerts, or any significant occurrences. Uses the v1 events endpoint, which Datadog has deprecated and serves only to organizations that have used it before.

<ReferenceDetails>

Expand All @@ -95,7 +95,8 @@ Post an event to the Datadog event stream. Use for deployment notifications, ale
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `event` | object | The created event details |
| ↳ `id` | number | Event ID |
| ↳ `id` | number | Event ID. Can lose precision above 2^53; prefer id_str |
| ↳ `id_str` | string | Event ID as an exact string |
| ↳ `title` | string | Event title |
| ↳ `text` | string | Event text |
| ↳ `date_happened` | number | Unix timestamp when event occurred |
Expand Down Expand Up @@ -280,7 +281,7 @@ Search and retrieve logs from Datadog. Use for troubleshooting, analysis, or mon
| `query` | string | Yes | Log search query using Datadog query syntax \(e.g., "service:web-app status:error", "host:prod-* @http.status_code:500"\) |
| `from` | string | Yes | Start time in ISO-8601 format or relative time \(e.g., "now-1h", "now-15m", "2024-01-15T10:00:00Z"\) |
| `to` | string | Yes | End time in ISO-8601 format or relative time \(e.g., "now", "now-5m", "2024-01-15T12:00:00Z"\) |
| `limit` | number | No | Maximum number of logs to return \(e.g., 50, 100, max: 1000\) |
| `limit` | number | No | Maximum number of logs to return \(default: 50, max: 5000\) |
| `cursor` | string | No | Pagination cursor from a previous call, taken from its nextLogId output. Omit for the first page. |
| `sort` | string | No | Sort order: "timestamp" for oldest first, "-timestamp" for newest first |
| `indexes` | string | No | Comma-separated list of log indexes to search |
Expand Down Expand Up @@ -476,6 +477,7 @@ Get the details of a single incident by ID. Requires the Incident Management `in
| ↳ `modified` | string | Last modification timestamp |
| ↳ `resolved` | string | Resolution timestamp |
| ↳ `time_to_resolve` | number | Seconds from creation to resolution |
| `included` | array | Related resources requested through include \(users, attachments\) |

</ReferenceDetails>

Expand Down Expand Up @@ -705,7 +707,7 @@ Update a service level objective. Reads the current SLO first and applies only t
| --------- | ---- | -------- | ----------- |
| `sloId` | string | Yes | The ID of the service level objective to update |
| `name` | string | No | New name for the SLO. Leave blank to keep the current name. |
| `type` | string | No | SLO type: "metric" or "monitor". Leave blank to keep the current type. Changing type requires supplying the matching query or monitorIds. |
| `type` | string | No | SLO type: "metric" or "monitor". Leave blank to keep the current type. Changing type requires supplying the matching query or monitorIds. Converting to a "time_slice" SLO is not supported. |
| `thresholds` | string | No | JSON array of thresholds replacing the stored ones, e.g. \[\{"timeframe": "30d", "target": 99.9, "warning": 99.95\}\]. Leave blank to keep the current thresholds. |
| `description` | string | No | Description of the SLO |
| `tags` | string | No | Comma-separated tags \(e.g., "env:prod,team:core"\) |
Expand Down Expand Up @@ -785,6 +787,7 @@ Get an SLO’s history over a time window, including the overall SLI value and r
| ↳ `monitors` | array | Per-monitor SLI data for multi-monitor SLOs |
| ↳ `thresholds` | object | Thresholds keyed by timeframe |
| `sliValue` | number | Overall SLI value over the window |
| `errors` | array | Errors Datadog hit while querying the history; the call can succeed with partial data |

</ReferenceDetails>

Expand Down
22 changes: 12 additions & 10 deletions apps/docs/content/docs/integrations/github.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,8 @@ Create comments on GitHub PRs
| `path` | string | No | File path for review comment |
| `commentType` | string | No | Type of comment \(pr_comment or file_comment\) |
| `line` | number | No | Line number for review comment |
| `side` | string | No | Side of the diff \(LEFT or RIGHT\) |
| `commitId` | string | No | The SHA of the commit to comment on. Defaults to the pull request head commit. |

#### Output

Expand Down Expand Up @@ -208,6 +210,8 @@ Retrieve the latest commit from a GitHub repository

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `sha` | string | Commit SHA |
| `html_url` | string | GitHub web URL |
| `commit` | object | Core commit data |
| ↳ `url` | string | Commit API URL |
| ↳ `message` | string | Commit message |
Expand Down Expand Up @@ -246,8 +250,6 @@ Retrieve the latest commit from a GitHub repository
| ↳ `html_url` | string | Profile page URL |
| ↳ `type` | string | User or Organization |
| ↳ `site_admin` | boolean | GitHub staff indicator |
| `sha` | string | Commit SHA |
| `html_url` | string | GitHub web URL |

</ReferenceDetails>

Expand Down Expand Up @@ -629,7 +631,7 @@ Get the list of files changed in a pull request
| ↳ `contents_url` | string | Contents API URL |
| ↳ `patch` | string | Diff patch |
| ↳ `previous_filename` | string | Previous filename \(for renames\) |
| `count` | number | Total number of files |
| `count` | number | Number of files in this page |

</ReferenceDetails>

Expand Down Expand Up @@ -1383,7 +1385,7 @@ Close an issue in a GitHub repository
| `owner` | string | Yes | Repository owner |
| `repo` | string | Yes | Repository name |
| `issue_number` | number | Yes | Issue number |
| `state_reason` | string | No | Reason for closing: completed or not_planned |
| `state_reason` | string | No | Reason for closing: completed, not_planned, or duplicate |

#### Output

Expand Down Expand Up @@ -1946,7 +1948,7 @@ List workflow runs for a repository, or for a single workflow when a workflow ID
| `actor` | string | No | Filter by user who triggered the workflow |
| `branch` | string | No | Filter by branch name |
| `event` | string | No | Filter by event type \(e.g., push, pull_request, workflow_dispatch\) |
| `status` | string | No | Filter by status \(queued, in_progress, completed, waiting, requested, pending\) |
| `status` | string | No | Filter by check run status or conclusion: queued, in_progress, completed, waiting, requested, pending, success, failure, cancelled, skipped, timed_out, action_required, neutral, or stale. Omit \(or pass "all"\) for every run. |
| `per_page` | number | No | Number of results per page \(default: 30, max: 100\) |
| `page` | number | No | Page number of results to fetch \(default: 1\) |

Expand Down Expand Up @@ -2217,8 +2219,8 @@ Search for code across GitHub repositories. Use qualifiers like repo:owner/name,
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `q` | string | Yes | Search query with optional qualifiers \(repo:, language:, path:, extension:, user:, org:\) |
| `sort` | string | No | Sort by indexed date \(default: best match\) |
| `order` | string | No | Sort order: asc or desc \(default: desc\) |
| `sort` | string | No | Sort by "indexed" \(how recently GitHub indexed the file\); default is best match. GitHub has deprecated this parameter and is closing it down. |
| `order` | string | No | Sort order: asc or desc \(default: desc\). Ignored unless sort is set; GitHub has deprecated this parameter and is closing it down. |
| `per_page` | number | No | Results per page \(max 100, default: 30\) |
| `page` | number | No | Page number \(default: 1\) |

Expand Down Expand Up @@ -2627,7 +2629,7 @@ List commits in a repository with optional filtering by SHA, path, author, commi

### GitHub Get Commit

Get detailed information about a specific commit including files changed and stats
Get detailed information about a specific commit including files changed and stats. GitHub returns at most the first 300 changed files of a larger commit.

<ReferenceDetails>

Expand Down Expand Up @@ -2723,8 +2725,8 @@ Compare two commits or branches to see the diff, commits between them, and chang
| `repo` | string | Yes | Repository name |
| `base` | string | Yes | Base branch/tag/SHA for comparison |
| `head` | string | Yes | Head branch/tag/SHA for comparison |
| `per_page` | number | No | Results per page for files \(max 100, default: 30\) |
| `page` | number | No | Page number for files \(default: 1\) |
| `per_page` | number | No | Commits per page \(max 100\). Setting per_page or page paginates the commit list, and changed files are returned only on page 1. Leave both unset to get up to 250 commits and every changed file in one response. |
| `page` | number | No | Page of the commit list. Changed files are returned only on page 1. Omit both page and per_page to get up to 250 commits in one response. |

#### Output

Expand Down
9 changes: 5 additions & 4 deletions apps/docs/content/docs/integrations/gitlab.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -420,6 +420,7 @@ Merge a merge request in a GitLab project
| `squash` | boolean | No | Squash commits before merging |
| `shouldRemoveSourceBranch` | boolean | No | Delete source branch after merge |
| `mergeWhenPipelineSucceeds` | boolean | No | Merge when pipeline succeeds |
| `sha` | string | No | HEAD SHA of the source branch; the merge fails if it does not match. Required when the group or instance requires a commit SHA on the merge requests API. |

#### Output

Expand Down Expand Up @@ -1024,7 +1025,7 @@ Add an existing GitLab user to a project or group at a given access level
| `resourceId` | string | Yes | Project or group ID or path \(e.g. mygroup/myproject\) |
| `userId` | number | No | The ID of the user to add. Provide either userId or username. |
| `username` | string | No | The username of the user to add. Provide either userId or username. |
| `accessLevel` | number | Yes | Access level: 0 \(No access\), 5 \(Minimal\), 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\) |
| `accessLevel` | number | Yes | Access level: 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\). 5 \(Minimal access\) is also valid for a top-level group on Premium and Ultimate. |
| `expiresAt` | string | No | Access expiration date in YYYY-MM-DD format |
| `memberRoleId` | number | No | Custom member role ID \(GitLab Ultimate only\) |

Expand All @@ -1050,7 +1051,7 @@ Update a member's access level in a GitLab project or group
| `resourceType` | string | Yes | Whether the resource is a 'project' or a 'group' |
| `resourceId` | string | Yes | Project or group ID or path \(e.g. mygroup/myproject\) |
| `userId` | number | Yes | The ID of the member to update |
| `accessLevel` | number | Yes | New access level: 0 \(No access\), 5 \(Minimal\), 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\) |
| `accessLevel` | number | Yes | New access level: 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\). 5 \(Minimal access\) is also valid for a top-level group on Premium and Ultimate. |
| `expiresAt` | string | No | Access expiration date in YYYY-MM-DD format. Pass an empty string to clear an existing expiration. |
| `memberRoleId` | number | No | Custom member role ID \(GitLab Ultimate only\). Warning: when omitted, GitLab removes any custom role the member currently holds. |

Expand Down Expand Up @@ -1099,7 +1100,7 @@ Invite a person to a GitLab project or group by email address
| `resourceType` | string | Yes | Whether the resource is a 'project' or a 'group' |
| `resourceId` | string | Yes | Project or group ID or path \(e.g. mygroup/myproject\) |
| `email` | string | Yes | Email address to invite \(comma-separated for multiple\) |
| `accessLevel` | number | Yes | Access level: 0 \(No access\), 5 \(Minimal\), 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\) |
| `accessLevel` | number | Yes | Access level: 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\). 5 \(Minimal access\) is also valid for a top-level group on Premium and Ultimate. |
| `expiresAt` | string | No | Access expiration date in YYYY-MM-DD format |
| `memberRoleId` | number | No | Custom member role ID \(GitLab Ultimate only\) |
| `inviteSource` | string | No | Identifier recorded as the source of the invitation \(for attribution\) |
Expand Down Expand Up @@ -2018,7 +2019,7 @@ Add a SAML group link that maps an identity-provider group to a GitLab group at
| --------- | ---- | -------- | ----------- |
| `groupId` | string | Yes | Group ID or path \(e.g. my-org/my-group\) |
| `samlGroupName` | string | Yes | The name of the SAML group as sent by the identity provider |
| `accessLevel` | number | Yes | Access level granted to members of the SAML group: 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\) |
| `accessLevel` | number | Yes | Access level granted to members of the SAML group: 10 \(Guest\), 15 \(Planner\), 20 \(Reporter\), 25 \(Security Manager\), 30 \(Developer\), 40 \(Maintainer\), 50 \(Owner\). 5 \(Minimal access\) is also valid for a top-level group. |
| `memberRoleId` | number | No | Custom member role ID \(GitLab Ultimate only\) |
| `provider` | string | No | Unique provider name that must match for this group link to be applied \(GitLab 18.2+\) |

Expand Down
Loading
Loading